Skip to main content
GET
List Payins
A payin is money received into the account, credited either to the trading account or to one of the account’s virtual accounts. Results are ordered by creation time, newest first. There are no sort parameters. Voided payins are excluded from this list by default; pass status=voided to see them, or fetch one directly with Get Payin. Requires an API key with read access on the payments scope.

Path Parameters

string
required
The account’s external ID (starts with acct_)

Query Parameters

string
Filter by payin status: pending, completed, failed or voided. When omitted, every status except voided is returned.
string
Filter by currency code: a supported fiat code (for example USD, EUR, GBP) or one of USDC, USDT
string
Filter by the rail the money arrived on: any value of payment_rail on the payin object (swift, ach, fedwire, sepa, crypto, manual, …).
string
Return only payins credited to this virtual account (starts with va_). The virtual account must belong to this account. An unknown or foreign id returns 404, not an empty page.
string
Filter payins created on or after this date (ISO 8601, inclusive)
string
Filter payins created before this date (ISO 8601, exclusive)
integer
default:"1"
Page number (minimum 1)
integer
default:"10"
Items per page (1-100)

Response

Each item is the full payin object. The same shape Get Payin returns.
array
Payin objects, newest first
integer
Current page number
integer
Items per page
integer
Total number of items
integer
Total number of pages

Errors

Request Example

Response Example