Get Transaction History

GET

/transactions

Get your transaction history including both credits added (payments) and credits spent (solves).

Returns:

Last 100 transactions by default

Sorted by newest first

Includes balance after each transaction

Transaction Types:

payment - Credits added via crypto payment

usage - Credits spent on captcha solve

refund - Credits refunded (e.g., failed solve)

bonus - Promotional credits

Use Cases:

Display transaction history in your UI

Generate usage reports

Track spending patterns

Reconcile payments

Export for accounting purposes

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

Transaction history

Body

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/transactions?limit=50&type=usage' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Mixed transactions

[
    {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "amount": 1000,
        "type": "payment",
        "description": "Credit top-up via BTC",
        "balance_after": 5000,
        "created_at": "2024-01-20T10:00:00Z"
    },
    {
        "id": "8d0f7780-8536-51ef-a55c-f18gd2g01bf8",
        "amount": -0.5,
        "type": "usage",
        "description": "Geetest v4 solve",
        "reference_id": "solve_abc123",
        "balance_after": 4999.5,
        "created_at": "2024-01-20T11:30:00Z"
    },
    {
        "id": "9e1f8891-9647-62fg-b66d-g29he3h12cg9",
        "amount": -0.5,
        "type": "usage",
        "description": "Turnstile solve",
        "reference_id": "solve_def456",
        "balance_after": 4999,
        "created_at": "2024-01-20T11:32:00Z"
    }
]

Modified at 2025-10-30 19:25:55

Get Credit Balance

Get Solve Request History