GET
/v1/treasury/inbound_transfersList inbound transfers
Lists InboundTransfers associated with a specified FinancialAccount. Use status to filter transfer state and use starting_after, ending_before, and limit to paginate the results.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
ending_beforestringoptional
A cursor that returns InboundTransfers before the specified object ID.
expandarray<string>optional
Fields to expand in each response object; each field name must not exceed 5,000 characters.
financial_accountstringrequired
The identifier of the FinancialAccount associated with the InboundTransfers to list.
limitintegeroptional
The number of InboundTransfers to return, from 1 to 100. Defaults to 10 when omitted.
starting_afterstringoptional
A cursor that returns InboundTransfers after the specified object ID.
statusstringoptional
Filters InboundTransfers by status: `canceled`, `failed`, `processing`, or `succeeded`.
200Returns a paginated list object containing InboundTransfer objects in `data`, a `has_more` indicator, the list object type, and the list URL.
dataarray<InboundTransfer>required
Details about each object.
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired
Error handling
financial_account must identify the FinancialAccount whose inbound transfers you want to list. limit must be between 1 and 100 and defaults to 10 when omitted, while status must be canceled, failed, processing, or succeeded.