Sign in
latestOpenAPI 3.0.32026-08-224982,0272.8 MB

e445c15e5bee

Link Transfers

List transfers

Lists transfers for an enterprise with filtering, pagination, and sorting.

get/api/link/v1/enterprises/{enterpriseId}/transfers

Path parameters

enterpriseIdstring required
Example:59cd72485007a239fb00282ed480da1f

Your enterprise id.

Query parameters

string required
OR
50 required

Maximum number of results to return per page. Defaults to 50.

string required
OR
0 required

Number of results to skip before returning. Defaults to 0.

accountIdsstring[]

Filter transfers to one or more accounts within the enterprise.

[
  "\"aba3a693-4f28-4523-8e53-85a3df22a608\""
]
statusstring[]

Filter by one or more transfer statuses.

[
  "\"completed\""
]
genericAssetstring
Example:btc

Filter by generic asset identifier.

fromType'address' | 'bitgo_wallet' | 'link_account' | 'venue_account'
Example:address

Filter by source entity type.

toType'address' | 'bitgo_wallet' | 'link_account' | 'venue_account'
Example:bitgo_wallet

Filter by destination entity type.

type'send' | 'receive'
Example:send

Filter by transfer direction relative to the account. "send" returns withdrawals (negative amount), "receive" returns deposits (positive amount).

startDatestring date-time
Example:2024-01-01T00:00:00.000Z

Return transfers created on or after this date (ISO 8601).

endDatestring date-time
Example:2024-12-31T23:59:59.999Z

Return transfers created on or before this date (ISO 8601).

orderDirection'asc' | 'desc' required
Example:desc

Sort direction for sortTimestamp (venue creation time, falls back to ingestion time). Defaults to desc.

searchLabelstring
Example:abc123

Case-insensitive search across transfer fields: transfer ID, fromId, toId, fromName, and toName.

toAddressstring
Example:TQrZ9wBLXKnNF8WiyQqMnxQyG3MJC4mYQv

Filter to transfers whose on-chain destination address matches this value (exact match). Joins through the crypto-detail relation; transfers without a crypto detail are excluded when this filter is set.

Headers

user-idstring required

User id of the user making the request.

Response

OK

totalnumber required

Total number of transfers matching the filter across all pages (same for every page). Use with limit/offset for pagination.