Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.splox.io/llms.txt

Use this file to discover all available pages before exploring further.

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

ParameterTypeDefaultDescription
pageinteger1Page number (1-based)
limitinteger20Items per page (1–100)
typesstring—Comma-separated filter: credit, debit, refund
statusesstring—Comma-separated filter: pending, completed, failed
start_datestring—Start date (YYYY-MM-DD)
end_datestring—End date (YYYY-MM-DD, inclusive)
min_amountnumber—Minimum amount in dollars
max_amountnumber—Maximum amount in dollars
searchstring—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

TypeDescription
creditFunds added (top-up, refund)
debitFunds deducted (workflow execution cost)
refundRefund of a previous charge

​
Transaction Statuses

StatusDescription
pendingTransaction is processing
completedTransaction completed successfully
failedTransaction 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.