---
title: "List transfers for an account"
method: GET
path: "/v1beta1/acats/{account_id}"
tags: ["ACATS"]
---

# List transfers for an account

`GET /v1beta1/acats/{account_id}`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1beta1/acats/{account_id}`
- Auth: HTTP basic

List all incoming and outgoing transfers where the account was one of the parties. The list may include transfers not initiated using this API. By default, the response includes all transfers for the account for backwards compatibility. To paginate results, provide the `limit` query parameter and use the `page_token` value returned in the response to continue listing transfers.

## Path parameters

- `account_id` string, uuid, required

## Query parameters

- `limit` integer
- `page_token` string: Page token, pass it back unchanged in the `page_token` query parameter to fetch the next or previous page.

## Response `200`

OK

- AcatsListTransfersResponse: A page of ACATS transfers, with optional pagination tokens.
  - `page_token_next` string: Page token, pass it back unchanged in the `page_token` query parameter to fetch the next or previous page.
  - `page_token_previous` string: Page token, pass it back unchanged in the `page_token` query parameter to fetch the next or previous page.
  - `pending_transfers` integer: The count of ACATS transfers pending review
  - `transfers` AcatsTransfer[], required
    - `acats_id` string, uuid, required: The ID of the ACATS transfer
    - `account_id` string, uuid, required: Account ID associated with the ACATS transfer
    - `account_name` string: Name on the Alpaca account associated with the transfer
    - `account_number` string, required: Account number at Alpaca
    - `account_type` 'AGENCY' | 'BANK_CUSTODY' | 'BENEFICIARY' | 'BENEFICIARY_ROTH_IRA' | 'CORPORATE' | 'CO_TRUSTEE' | 'COVERDELL_IRA' | 'CUSTODIAN_UGMA' | 'DIRECT_ROLLOVER' | 'ESTATE' | 'HSA' | 'IRA' | 'JOINT' | 'MEDICAL_SAVINGS_ACCOUNT' | 'OTHER' | 'QUALIFIED_OR_PROFIT_SHARING_OR_PENSION' | 'ROTH_401K' | 'ROTH_IRA' | 'ROTH_SEP' | 'ROTH_SIMPLE' | 'ROTH_SOLO_401K' | 'SARSEP' | 'SEP_IRA' | 'SIMPLE_IRA' | 'SINGLE' | 'SOLO_401K' | 'TRUST' | 'TYPE_401K' | 'TYPE_403B' | 'TYPE_457_PLAN' | 'TYPE_529_PLAN': Account type, as represented by DTCC
    - `contra_account_number` string, required: Account number at the contra broker
    - `contra_broker_name` string: Name of the contra broker
    - `contra_broker_number` string, required: DTCC account number for the contra broker
    - `contra_broker_type` 'BANK' | 'BROKER': ACATS participant type
    - `created_at` string, date-time, required: Timestamp in RFC-3339 format with microsecond precision
    - `direction` 'INCOMING' | 'OUTGOING', required: Transfer direction
    - `ip_address` string: User's IP address (IPv4 or IPv6) at time of submission
    - `original_transfer_identifier` string: DTCC transfer identifier for a previous, related transfer
    - `rejection_details` AcatsRejectionDetails: Why the transfer was rejected, only present on transfers in rejected status
      - `rejection_message` string: Human readable message regarding the reason for the rejection
      - `rejection_reason` 'SS_TAX_ID_MISMATCH' | 'ACCOUNT_TITLE_MISMATCH' | 'DOCUMENTATION_NEEDED' | 'ACCOUNT_FLAT' | 'INVALID_ACCOUNT_NUMBER' | 'DUPLICATE' | 'ACCOUNT_IN_DISTRIBUTION_OR_TRANSFER' | 'CLIENT_RESCINDED' | 'MISSING_AUTHORIZATION_SIGNATURE' | 'ACCOUNT_VIOLATES_CREDIT_POLICY_OF_RECEIVING_FIRM' | 'UNRECOGNIZED_FOR_RESIDUAL_CREDIT_BALANCE' | 'PARTIAL_TRANSFER_DELIVERER_INITIATED_REJECT' | 'FAIL_REVERSAL_REJECT' | 'RECLAIM_REJECT' | 'MUTUAL_FUND_CLEANUP' | 'SYSTEM_REJECTED' | 'INVALID_PARTICIPANT' | 'ASSOCIATED_RECORD_NOT_PRESENT_OR_INVALID' | 'MISSED_CUTOFF': Rejection reason, as returned by DTCC
    - `settlement_date` string, date-time: Timestamp in RFC-3339 format with microsecond precision
    - `status` AcatsStatusDetails, required: Status details
      - `dtcc_status` 'REQUEST' | 'REQUEST_ADJUST' | 'REQUEST_ADJUST_PAST' | 'REQUEST_PAST' | 'REQUEST_REJECT' | 'REVIEW' | 'REVIEW_ADJUST_DELIVERER' | 'REVIEW_ERROR' | 'REVIEW_ACCELERATE' | 'REVIEW_ADJUST_RECEIVER_ACCELERATE' | 'SETTLE_PREP' | 'SETTLE_CLOSE' | 'CLOSE_PURGE' | 'REQUEST_PTR' | 'MEMO_PURGE_PARTIAL_TRANSFER_REQUEST_RECEIVER' | 'REJECT' | 'SYSTEM_REJECTED': Transfer status as tracked by DTCC
      - `transfer_status` 'PENDING' | 'IN_PROGRESS' | 'REJECTED' | 'SETTLED': Transfer status as tracked by Alpaca
    - `total_transfer_value` string, decimal: Total transfer value is the sum of the market value of all assets and securities in an ACAT at the time of settlement, plus any cash balance.
    - `transfer_identifier` string: DTCC transfer identifier, also known as the control number
    - `transfer_type` 'FUL' | 'FRV' | 'MFC' | 'PTD' | 'PTR' | 'RCL' | 'RCR' | 'PTF', required: ACATS transfer type

## Other responses

- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)