API Overview

Production Base URL

https://api.outception.com/v1

Auth (Organization)

Use an Organization Access Token (OAT) in the Authorization: Bearer header

Auth (OAuth2)

Authenticate users via the OAuth 2.0 authorization flow

Base URLs

Environment	Base URL	Purpose
Production	`https://api.outception.com/v1`	Live data

Authentication

Most read endpoints (news) are open. Organization-scoped endpoints require authentication via an Organization Access Token (OAT) or an OAuth 2.0 access token.

Organization Access Tokens (OAT)

Use an OAT to act on behalf of your organization.

Authorization: Bearer outception_oat_xxxxxxxxxxxxxxxxx

OAuth 2.0

For user-facing apps, authenticate users through the OAuth 2.0 authorization flow and call the API with the issued access token. See: OAuth 2.0.

Quick Examples

curl https://api.outception.com/v1/news/sources \
  -H "Accept: application/json"

Pagination

List endpoints in the Outception API support pagination to help you efficiently retrieve large datasets. Use the page and limit query parameters to control pagination.

Query Parameters

Parameter	Type	Default	Max	Description
`page`	integer	`1`	-	Page number, starting from 1
`limit`	integer	`10`	`100`	Number of items to return per page (window size)

Response Format

All paginated responses include a pagination object with metadata about the current page and total results:

Field	Type	Description
`total_count`	integer	Total number of items matching your query across all pages
`max_page`	integer	Total number of pages available, given the current `limit` value

Rate Limits

The Outception API has rate limits to ensure fair usage and maintain performance.

500 requests per minute per organization or OAuth2 client.

If you exceed the rate limit, you will receive a 429 Too Many Requests response. The response will include a Retry-After header indicating how long you should wait before making another request.