List transfers
Lists the organisation’s transfers, open and closed, newest first. accountId narrows to the transfers with that account at either end; the status, each account, the asset and the overdue flag filter as on every collection. A member without the surface is 503 TRANSFERS_UNAVAILABLE. Needs transfers:read or any transfers capability.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Headers
Your own id for the request: 8 to 128 of [A-Za-z0-9._-]. It becomes the request’s id and is echoed on the response. A value off that grammar is replaced with a fresh id, never refused.
Query parameters
Only transfers with this account at either end — as sourceAccountId or as destAccountId. One id; anything but a positive 32-bit integer refuses 400 MALFORMED_REQUEST.
Only rows whose transferId is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not a positive 64-bit integer in decimal digits) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.
Only rows whose status is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not one of the values listed) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.
Only rows whose sourceAccountId is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not a positive 32-bit integer) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.
Only rows whose destAccountId is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not a positive 32-bit integer) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.
Only rows whose assetId is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not a positive 32-bit integer) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.
Only rows whose isOverdue is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not true or false) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.
Comma-separated transferId, status, sourceAccountId, destAccountId, assetId, isOverdue, submittedAtNs or updatedAtNs; prefix - for descending. Default -transferId, the newest first.
Page size, 1-100; larger values are clamped. Without it the whole collection is served as one page.
nextCursor or prevCursor from a previous page, sent with the same filters and the same sort. One that does not decode, or that came from another query, is refused 400 INVALID_CURSOR: drop it and fetch the first page.
total adds the exact number of rows matching the filters. This collection has no terminal state, so include takes total alone: deleted is a value off its grammar (400).
A position you hold — an X-Immix-Global-Sequence you read, or a 202’s commandGlobalSequence: this member answers only once it has folded the platform’s stream through it, waiting up to its deadline, then 503 PROJECTION_BEHIND with Retry-After. Within that stream a read is never older than what you have seen; drop your positions after an announced stream cut. A retry stating its 202’s position attaches to or replays that operation while the journal holds its key, never publishing twice. Stated once: one to nineteen digits, at most 9223372036854775807; else 400 MALFORMED_REQUEST.
Response
A page of the transfers inside the principal’s org, in the operation’s order, or the one sort asks — all of them unless limit is sent; the position it was read at rides the body and the headers.
The sequencer timestamp (epoch-ns) the data is complete through; also sent as X-Immix-As-Of-Seq-Ts. Null when unknown.
The position as a decimal string — the last change this member had applied, orders, balance readings and algo instances included.
Pass as cursor for the next page. Null on the last page.
Pass as cursor for the previous page. Null on the first page.
Exact count matching the filter. Null unless include=total.