# Get transfer by ID

Retrieves the details of a specific transfer by its ID.

Endpoint: GET /v1/collections/transfers/{transfer_id}
Version: 1.0.0
Security: Bearer

## Path parameters:

  - `transfer_id` (string, required)
    Unique identifier of the transfer to retrieve
    Example: "6f3e9c2a-1b4d-47f0-9e3a-2c6b8d1f5a7e"

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the transfer
    Example: "6f3e9c2a-1b4d-47f0-9e3a-2c6b8d1f5a7e"

  - `status` (string, required)
    Status of the transfer
    Enum: "PENDING", "PROCESSING", "COMPLETED", "EXPIRED", "FAILED", "CANCELLED"

  - `source` (object, required)
    Account and amount moved on one side of a transfer

  - `source.account_id` (string)
    Unique identifier of the account
    Example: "b2c3d4e5-f6a7-8901-bcde-f12345678901"

  - `source.currency` (string)
    Currency of the account
    Example: "USD"

  - `source.amount` (string)
    Amount moved, as a string to preserve precision
    Example: "1000.00"

  - `destination` (object, required)
    Account and amount moved on one side of a transfer

  - `market_rate` (object, required)
    Market exchange rate at the time the transfer's quote was created. Base=counter=1 for same-currency transfers.

  - `market_rate.base` (string)
    Example: "USD"

  - `market_rate.counter` (string)
    Example: "BRL"

  - `market_rate.rate` (string)
    Market rate as a string to preserve precision
    Example: "5.25"

  - `exchange_rate` (object, required)
    Quoted exchange rate applied to this transfer, including spread. Base=counter=1 for same-currency transfers.

  - `exchange_rate.base` (string)
    Example: "USD"

  - `exchange_rate.counter` (string)
    Example: "BRL"

  - `exchange_rate.rate` (string)
    Quoted rate as a string to preserve precision
    Example: "5.20"

  - `fees` (object, required)
    Fees charged on this transfer

  - `fees.transaction_fee` (object)
    Spread between market_rate and exchange_rate, applied to the source amount. Zero for same-currency transfers.

  - `fees.transaction_fee.amount` (string)
    Example: "50.00"

  - `fees.transaction_fee.currency` (string)
    Currency the fee is denominated in (always the destination currency)
    Example: "BRL"

  - `reason` (string,null)
    Reason for the current status, populated on terminal FAILED status (if applicable)

  - `expires_at` (string, required)
    ISO 8601 timestamp after which a PENDING transfer can no longer be confirmed
    Example: "2025-09-18T23:09:00.542Z"

  - `created_at` (string, required)
    ISO 8601 timestamp when the transfer was created
    Example: "2025-09-18T22:54:00.542Z"

  - `updated_at` (string, required)
    ISO 8601 timestamp when the transfer was last updated
    Example: "2025-09-18T22:54:00.542Z"

## Response 401 fields (application/json):

  - `code` (string, required)
    Error code identifying the type of error

  - `reason` (string, required)
    Human-readable error message