Returns paginated, filterable transaction history for the authenticated user. Supports filtering by type, status, date range, amount range, and search.
Usage
curl "https://app.splox.io/api/v1/billing/transactions?page=1&limit=20&types=debit" \
-H "Authorization: Bearer YOUR_TOKEN"
Query Parameters
| Parameter | Type | Default | Description |
|---|
page | integer | 1 | Page number (1-based) |
limit | integer | 20 | Items per page (1–100) |
types | string | — | Comma-separated filter: credit, debit, refund |
statuses | string | — | Comma-separated filter: pending, completed, failed |
start_date | string | — | Start date (YYYY-MM-DD) |
end_date | string | — | End date (YYYY-MM-DD, inclusive) |
min_amount | number | — | Minimum amount in dollars |
max_amount | number | — | Maximum amount in dollars |
search | string | — | Search in description and metadata |
Response
{
"transactions": [
{
"id": "0199f123-d60e-7ffd-9131-4cc5ab040ee8",
"user_id": "0199d001-c45d-9e0f-3456-789012cdef01",
"amount": 8700,
"currency": "USD",
"type": "debit",
"status": "completed",
"description": null,
"metadata": null,
"stripe_payment_intent_id": null,
"stripe_charge_id": null,
"created_at": "2026-02-08T13:57:39Z",
"updated_at": "2026-02-08T13:57:39Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total_count": 73143,
"total_pages": 3658,
"has_next": true,
"has_prev": false
}
}
Transaction Types
| Type | Description |
|---|
credit | Funds added (top-up, refund) |
debit | Funds deducted (workflow execution cost) |
refund | Refund of a previous charge |
Transaction Statuses
| Status | Description |
|---|
pending | Transaction is processing |
completed | Transaction completed successfully |
failed | Transaction failed |
Amounts are in microdollars. Divide by 1,000,000 to get USD. For example, 8700 = $0.0087.
Notes
Authentication required. Only the authenticated user’s transactions are returned.
