v1

latestOpenAPI 3.0.32026-07-2650226215.9 KB

Transaction

List transactions with filters

List transactions with filters.

Results are ordered newest-first (by createdAt desc, id desc). limit defaults to 50 and is capped at 100.

Date filters createdAfter and createdBefore are inclusive (treated as >= and <= against createdAt).

Pagination returns opaque nextCursor / previousCursor tokens in the response whenever the page is non-empty: use startingAfter=nextCursor to fetch the next page, or endingBefore=previousCursor to page backward. hasMore tells the client whether more rows exist in the current direction of travel; an empty response in the other direction signals the start of the list.

get/transactions

Query parameters

limitinteger

startingAfterstring

endingBeforestring

statusTransactionStatus[]

Filter by status.

sourceToDestinationSourceToDestination[]

Filter by corridor (source/destination category composite).

customerIdstring

Scope to a customer. Matches rows where the customer is on either side

the sender (quote owner) or the recipient. Replaces the retired GET /customers/{id}/transactions. cst_ prefix.

walletIdstring

Filter to the transaction's originating OMS wallet (the precursor's source wallet). wlt_ prefix (legacy acc_ also accepted).

virtualAccountIdstring

Filter to the transaction's originating virtual account. va_ prefix.

depositAddressIdstring

Filter to the transaction's originating deposit address. da_ prefix.

cashInIdstring

Filter to the transaction's originating cash-in. ci_ prefix.

createdAfterstring date-time

Inclusive lower bound on createdAt.

createdBeforestring date-time

Inclusive upper bound on createdAt.

searchstring

Free-text search. Matches transaction id, customer id, or customer email.

qstring

Alias for search.

legStatusstring[]

Filters to payments where ANY leg's underlying status is in the given set (e.g. failed surfaces outbound-failed-funds-held payments whose derived overall status is still processing). Values are leg-level statuses, a superset of TransactionStatus. Only applied under the grouped read model; ignored otherwise.

Response

The request has succeeded.

objectstring

Resource type discriminator.

hasMoreboolean

True when more rows exist beyond this page in the direction of travel (forward by default, backward when endingBefore was supplied).

nextCursorstring

Opaque cursor pointing at the last item in this page. Present when data is non-empty. Pass as startingAfter to fetch the next page; hasMore=false signals no more pages forward.

previousCursorstring

Opaque cursor pointing at the first item in this page. Present when data is non-empty. Pass as endingBefore to page backward; when this yields an empty response the client is at the start of the list.