List transfer approval requests

get

https://api.mercury.com/api/v1/request-transfer

Retrieve a paginated list of transfer approval requests for the authenticated organization. Supports filtering by source account, destination account, and status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

sourceAccountId

uuid

ID for a Mercury account.

destinationAccountId

uuid

ID for a Mercury account.

status

string

enum

Allowed:

start_at

uuid

The ID of the transfer approval request to start the page at (inclusive). Cannot be combined with start_after or end_before.

start_after

uuid

The ID of the transfer approval request to start the page after (exclusive). When provided, results will begin with the transfer approval request immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.

end_before

uuid

The ID of the transfer approval request to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.

limit

int64

1 to 1000

Defaults to 1000

Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000

order

string

enum

Defaults to asc

Sort order. Can be 'asc' or 'desc'. Defaults to 'asc'

Allowed:

Responses

400

Invalid order or limit or end_before or start_after or start_at or status or destinationAccountId or sourceAccountId

200