Sign in

v4

latestOpenAPI 3.0.32026-08-0161180264.4 KB
monitoring
integrations

queryAccessLogs

Query API access logs for a specific integration's organization. Returns access token usage analytics filtered by user_id (access token). Supports infinite scroll pagination with cursor-based navigation.

post/v1/integrations/{integrationId}/monitoring/access-logs

Path parameters

integrationIdstring uuid required

The integration ID (used for tenant authorization)

Request body

token_idstring

Filter by a specific access token ID (e.g., 'api_5ZugdRXasLfWBypHi93Fk'). Must be one of the access_token_ids linked to the integration. If omitted, returns logs for all access tokens linked to the integration.

servicestring

Filter by service name (e.g., 'entity', 'metering', 'submission-api')

method'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD'

Filter by HTTP method

pathstring

Filter by request path (partial match)

statusinteger

Filter by HTTP status code

from_datestring date-time

Filter logs from this date (inclusive)

to_datestring date-time

Filter logs until this date (inclusive)

limitinteger

Maximum number of results to return

Example request

{
  "token_id": "api_5ZugdRXasLfWBypHi93Fk",
  "service": "entity",
  "path": "/v1/entity",
  "status": 200,
  "from_date": "2025-01-01T00:00:00Z",
  "to_date": "2025-01-31T23:59:59Z",
  "limit": 50
}

Response

Access logs queried successfully

has_moreboolean

Indicates if more results are available