List transfers

get

https://broker-api.sandbox.alpaca.markets/v1beta1/acats

List all incoming and outgoing transfers, for all accounts. The list may include transfers not initiated using this API. The list is paginated: use the page_token query parameter with the value returned in the response to continue listing transfers.

Query Params

account_number

string

Filter by the account number associated with the transfer

transfer_type

string

enum

Filter by the type of the transfer

transfer_direction

string

enum

Filter by the direction of the transfer

Allowed:

transfer_status

string

enum

Filter by the current status of the transfer

Allowed:

dtcc_status

string

enum

Filter by the current DTCC status of the transfer

contra_broker_number

string

Filter by the contra broker number of the transfer

since

date-time

List transfers created at or after this RFC-3339 timestamp (e.g. 2026-01-01T00:00:00Z).

until

date-time

List transfers created strictly before this RFC-3339 timestamp (exclusive -- e.g. 2026-01-01T00:00:00Z excludes transfers created exactly at that instant).

sort_direction

string

enum

Defaults to DESC

Specify whether transfers should be sorted by creation time in ascending or descending order

Allowed:

sort_by

string

enum

Defaults to created_at

Specify the field to sort by. Defaults to created_at.

limit

int32

Maximum number of transfers to return on one page

page_token

string

Page token for the next or previous page, used to continue listing transfers

Responses

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad Request

403Forbidden

500Internal Server Error