Developers

Accounts

List ledger entries of an account

GET/accounts/{accountId}/transactions

Read-only ledger view of one account. Filters combine — an entry matches all of them — and a filter you repeat matches any of its values: ?status=pending&status=failed&direction=debit lists the pending and the failed money out, and ?direction=debit&amountFrom=500 every debit of 500 or more.

Authentication
ApiKeyAuth
Execution
synchronous

Parameters

  • accountIdstringpathrequired
    Opaque account identifier. Treat as a string; never parse or construct it.

    Example: acc_AAAAAAAAAAc

    pattern ^acc_[A-Za-z0-9_-]{11}$

  • limitintegerquery

    Default: 20

    ≥ 1 · ≤ 100

  • cursorstringquery
    Opaque cursor from a previous page's nextCursor.

    max length 512

  • createdAfterstring (date-time)query
    Inclusive lower bound on createdAt.
  • createdBeforestring (date-time)query
    Exclusive upper bound on createdAt.
  • typearrayquery
    Entries of any of these types (?type=payout&type=fee). refund/other cannot be filtered on (no single underlying type) → 400 validation_failed.
  • statusarrayquery
    Entries in any of these statuses (?status=pending&status=failed).
  • directionstringquery
    credit = money in (a positive amount), debit = money out (a negative amount). Omit for both.

    Allowed values: creditdebit

  • amountFromstringquery
    Inclusive lower bound on the entry's amount, without its sign and in the account's currency. Pair it with direction to bound money in or money out only.

    Example: 500.00

    pattern ^[0-9]+(\.[0-9]+)?$

  • amountTostringquery
    Inclusive upper bound on the entry's amount, without its sign and in the account's currency. Must not be below amountFrom.

    Example: 1000.00

    pattern ^[0-9]+(\.[0-9]+)?$

  • merchantReferencestringquery
    The entries your requests under this reference made — the same entries that show it as merchantReference. A reference nothing was made under lists no entries.

    max length 100

Responses

A page of ledger entries, newest first.

Headers

  • X-Request-Idstring
    The request's trace id: the same value a problem body carries as traceId. Quote it when you contact support. A replayed response (Idempotent-Replayed: true) carries the replay's own; its body keeps the original request's traceId.
  • RateLimit-Limitinteger
  • RateLimit-Remaininginteger
  • RateLimit-Resetinteger
    Seconds until the window resets.

Schema application/json

  • itemsarray<Transaction>
    • idstringrequired
      Opaque ledger-entry identifier. Treat as a string; never parse or construct it.

      Example: txn_AAAAAAAAB3Y

      pattern ^txn_[A-Za-z0-9_-]{11}$

    • accountIdstringrequired
      Opaque account identifier. Treat as a string; never parse or construct it.

      Example: acc_AAAAAAAAAAc

      pattern ^acc_[A-Za-z0-9_-]{11}$

    • typestringrequired
      payout = money out of your accounts — to an individual Jeton user, or to a bank account or crypto wallet, your own included — whatever the method (see method on the entry). transfer = a movement between accounts on the platform — to another of your own accounts or to another business — from the portal or POST /transfers. refund and return are not reported yet.

      Allowed values: paymentpayouttransferexchangerefundfeedepositadjustmentcampaignsavingsother

    • statusstringrequired
      pending covers every state that has not settled yet (a scheduled one too) · completed posted or settled · failed (also expired) · cancelled.

      Allowed values: pendingcompletedfailedcancelled

    • amountMoneyrequired
      Decimal amount as a string — never a float, never minor units. An amount you send may carry no more decimal places than its currency has (and never more than 8); trailing zeros do not count, so 10.100 EUR is fine and 10.123 EUR is 400 validation_failed on amount.value. An amount the API returns is written with exactly as many decimal places as its currency has (at most 8): 10.10 EUR, never 10.1.
    • feeobject
      Present when a fee was charged on this entry.
    • netobject

      What this entry changes your balance by once it completes, signed:

      • money out: amount with its fee on top (-100.00 with a 1.50 fee is -101.50);
      • money in: amount less its fee, except a deposit paid by card or another checkout method, whose payer paid the fee on top — you receive the whole amount.

      Summed over completed entries it is the change in your balance. Absent on failed and cancelled entries, which moved nothing, and on the rare card spend that was partly collected later on an entry of its own.

    • referencestring
      The reference carried on the rail (end-to-end / remittance), when any.
    • descriptionstring
    • counterpartyNamestring
    • merchantReferencestring
      The merchantReference of your request that made this entry: a payment's money in, a payout's or a transfer's debit, an exchange's sold side. Absent on entries no request of yours made — a portal payout, a fee — and on the other side of a transfer or an exchange. ?merchantReference= finds exactly the entries that show it.
    • sourceobject

      The resource this entry belongs to, when you can read it: GET the resource type names by this id.

      • payment: the money a payment took in.
      • payout: a payout's debit — its id is this entry's own. A Jeton wallet payout made as a transfer is a payout too.
      • transfer: a transfer's debit (its own id again), or the credit of a transfer between your own accounts (the debit's id).
      • fx_exchange: either side of an exchange.

      Absent on deposits, fees, adjustments, campaigns and savings, on money another business sent you (their transfer, not one you can read), and on refund, return and reversal entries.

    • methodstring
      Present on payout entries — which payout method moved the money.

      Allowed values: jeton_walletbank_transfercrypto

    • exchangeobject
      Present on exchange entries: the other side of the exchange — what was bought, on the account that sold; what was sold, on the account that bought. Unsigned; this entry's amount carries the direction.
    • createdAtstring (date-time)required
      RFC 3339, UTC, with millisecond precision.

      Example: 2026-09-18T10:15:30.123Z

    • completedAtstring (date-time)
      RFC 3339, UTC, with millisecond precision.

      Example: 2026-09-18T10:15:30.123Z

  • hasMorebooleanrequired
  • nextCursorstringnullable
    Pass as cursor to fetch the next page. null when hasMore is false.