Browse documentation

Credits API

Transactions

View your credit transaction history

GET
https://www.orthogonal.com/v1/credits/transactions

Returns your credit transaction history, including purchases, API call charges, and refunds.

Authentication

Requires a valid API key via Authorization: Bearer YOUR_API_KEY.

Query Parameters

limitnumberdefault: 50
Maximum number of transactions to return.
offsetnumberdefault: 0
Offset for pagination.

Response

{
"transactions": [
{
"id": "tx_abc123",
"type": "api_call",
"amountCents": -3000,
"description": "API call: apollo /v1/people/match",
"timestamp": "2026-02-27T10:30:00Z",
"metadata": {
"api": "apollo",
"path": "/v1/people/match"
}
},
{
"id": "tx_def456",
"type": "purchase",
"amountCents": 1000000,
"description": "Credit purchase: 10,000 credits",
"timestamp": "2026-02-25T14:00:00Z"
}
],
"pagination": {
"limit": 50,
"offset": 0,
"count": 2
}
}

Response Fields

FieldTypeDescription
transactionsarrayList of transactions
transactions[].idstringTransaction ID
transactions[].typestringTransaction type (api_call, purchase, refund, etc.)
transactions[].amountCentsnumberAmount (negative for charges, positive for credits)
transactions[].descriptionstringHuman-readable description
transactions[].timestampstringISO 8601 timestamp
transactions[].metadataobjectAdditional context (API slug, path, etc.)

Example

curl 'https://api.orthogonal.com/v1/credits/transactions?limit=20' \
-H 'Authorization: Bearer YOUR_API_KEY'