Skip to main content
GET
/
v1
/
credits
/
transactions
Transactions
curl --request GET \
  --url https://api.example.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

limit
number
default:"50"
Maximum number of transactions to return.
offset
number
default:"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.orth.sh/v1/credits/transactions?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'