---
title: "Get transfer details"
method: GET
path: "/v1beta1/acats/{account_id}/{acats_id}"
tags: ["ACATS"]
---

# Get transfer details

`GET /v1beta1/acats/{account_id}/{acats_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}/{acats_id}`
- Auth: HTTP basic

Includes the same information returned by the list transfers endpoints, but for just one transfer.

## Path parameters

- `account_id` string, uuid, required
- `acats_id` string, uuid, required

## Response `200`

OK

- AcatsTransfer: An ACATS transfer and its current status.
  - `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
- `404`: Not Found. No transfer with this `acats_id` exists for the given `account_id`.
- `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)