Documentation / SDK v1

Transactions

List and export wallet transactions via /sdk/v1.

transactions · json
{
  "success": true,
  "data": [
    {
      "transactionId": "txn_...",
      "transactionType": "TOP_UP",
      "transactionStatus": "COMPLETED",
      "transactionTime": "2026-02-19T00:00:00.000Z",
      "displayCurrency": "USD",
      "displayValue": 100,
      "feeDisplayValue": 0
    }
  ],
  "pagination": { "page": 1, "pageSize": 50, "totalItems": 1, "totalPages": 1 }
}
All documentation

All endpoints below require:

  • X-Application-Id
  • X-Api-Key

GET /sdk/v1/transactions

List agency wallet transactions.

Query parameters

  • page (default 1)
  • limit or pageSize (default 50, max 100)
  • sortBy (optional)
  • sortOrder (asc|desc, optional)
  • transactionTypes or transactionType (optional; comma-separated)
  • transactionStatuses or transactionStatus (optional; comma-separated)
  • from and to (optional; ISO timestamps)

If from/to is provided without a timezone offset, it is treated as UTC.

Supported transactionTypes values (invalid values are ignored):

TOP_UP, AGENCY_PAY_OUT, CREATOR_PAYMENT, TOP_UP_CREDIT

Supported transactionStatuses values (invalid values are ignored):

SUBMITTED, PENDING_VERIFICATION, PROCESSING, INSTANT_WALLET_TO_WALLET, PENDING_WALLET_TO_WALLET, DECLINED, COMPLETED

Response

{
  "success": true,
  "data": [
    {
      "transactionId": "txn_...",
      "transactionType": "TOP_UP",
      "transactionStatus": "COMPLETED",
      "transactionTime": "2026-02-19T00:00:00.000Z",
      "displayCurrency": "USD",
      "displayValue": 100,
      "feeDisplayValue": 0
    }
  ],
  "pagination": { "page": 1, "pageSize": 50, "totalItems": 1, "totalPages": 1 }
}

GET /sdk/v1/transactions/export

Export wallet transactions as CSV or PDF.

Query parameters

  • format (required): csv or pdf
  • from and to (required): ISO timestamps
  • All filters supported by GET /sdk/v1/transactions
  • timeZone (optional; used for PDF rendering)

Responses

  • text/csv with Content-Disposition: attachment; filename="wallet-transactions-YYYY-MM-DD.csv"
  • application/pdf with Content-Disposition: attachment; filename="wallet-transactions-YYYY-MM-DD.pdf"

If the export would exceed 10,000 rows: 413 with a JSON error.

Describe your program.

Grade turns it into a program it can track and pay.