Theme switcher

List transactions attributable to the calling publisher's users.

Header Parameters

Acceptstring

Media type the client can parse. Always application/json for this API.

Default value
application/json
Enum values:
application/json
Authorizationstring

Query Parameters

pageinteger

1-based page index for paginated collection endpoints. When omitted, the first page is returned. Response bodies include prev and next URLs for navigation.

Minimum
1
Maximum
10000
UIDstring

Filter results to a single end-user by the publisher-supplied unique identifier. When omitted, the endpoint returns records for all users belonging to the calling publisher.

Max length
255
Pattern
^[A-Za-z0-9._-]+$
from-datestring

Inclusive lower bound for date-range filtering. Format YYYY-MM-DD. Must be paired with to-date; both bounds apply or neither.

Pattern
^\d{4}-\d{2}-\d{2}$
to-datestring

Inclusive upper bound for date-range filtering. Format YYYY-MM-DD. Must be paired with from-date.

Pattern
^\d{4}-\d{2}-\d{2}$

Response

200
Object

Transaction list returned. Per-publisher-type variants are covered in the schema.

Response Attributes

One Of:

transactionsobject

Show child attributes

transactionsobject

Show child attributes

401
Object

Authentication failed. Common causes: missing Authorization header, malformed bearer token, token expired (tokens live 10 hours), or — on getToken itself — HMAC signature mismatch due to clock drift or wrong secret.

Response Attributes

messagestring

Human-readable failure reason. Safe to surface to integrators but not end-users.

errorstring

Alternative error message field used by a subset of endpoints (notably getToken and authentication failures). Integrators should check for both message and error when parsing failure responses.

responseinteger

Numeric status code echoing the HTTP status (e.g. 400, 401). Populated on most error paths; a few auth-layer failures omit it.

429
Object

Rate limit exceeded. The POST /getToken endpoint is rate-limited to five requests per minute per source IP; other endpoints may be throttled at the reverse-proxy layer in response to abusive traffic. Wait and retry with exponential backoff; the Retry-After header tells you the minimum wait in seconds.

Response Attributes

messagestring

Human-readable failure reason. Safe to surface to integrators but not end-users.

errorstring

Alternative error message field used by a subset of endpoints (notably getToken and authentication failures). Integrators should check for both message and error when parsing failure responses.

responseinteger

Numeric status code echoing the HTTP status (e.g. 400, 401). Populated on most error paths; a few auth-layer failures omit it.

Was this section helpful?

GET

/

Select
1

Response

Was this section helpful?
View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot