---
title: "Retrieve List of Transfers for an Account."
method: GET
path: "/v1/accounts/{account_id}/transfers"
tags: ["Funding"]
---

# Retrieve List of Transfers for an Account.

`GET /v1/accounts/{account_id}/transfers`

You can query a list of transfers for an account.


You can filter requested transfers by values such as direction and status.

Returns a list of transfer entities ordered by created_at

## Query parameters

- `direction` 'INCOMING' | 'OUTGOING'
- `limit` integer
- `offset` integer

## Response `200`

Success.

- Transfer[]
  - `account_id` string, uuid, required — The account ID
  - `additional_information` string, nullable — Additional information. Only applies when type = "wire".
  - `amount` string, decimal, required — Must be > 0.00
  - `bank_id` string, uuid — The ID of the Bank, only present if type = "wire"
  - `created_at` string, date-time, required — Timestamp when transfer was created
  - `direction` 'INCOMING' | 'OUTGOING', required — - **INCOMING** Funds incoming to user's account (deposit). - **OUTGOING** Funds outgoing from user's account (withdrawal).
  - `expires_at` string, date-time — Timestamp when transfer expires
  - `fee` string, decimal, nullable — Fee amount to be collected. Only applies when type = "wire".
  - `fee_payment_method` string, nullable — Either "user" or "invoice". Only applies when type = "wire".
  - `hold_until` string, date-time
  - `id` string, uuid, required — The transfer ID
  - `instant_amount` string
  - `ira` TransferIRADetails
    - `distribution_reason` string
    - `fed_withholding_amount` string
    - `fed_withholding_pct` string
    - `state_withholding_amount` string
    - `state_withholding_pct` string
    - `tax_year` string
  - `reason` string, nullable — Cause of the status
  - `relationship_id` string, uuid — The ACH relationship ID only present if type = "ach"
  - `requested_amount` string, decimal, nullable — Must be > 0.00. Only applies when type = "wire".
  - `status` 'QUEUED' | 'APPROVAL_PENDING' | 'PENDING' | 'SENT_TO_CLEARING' | 'REJECTED' | 'CANCELED' | 'APPROVED' | 'COMPLETE' | 'RETURNED', required — - **QUEUED** Transfer is in queue to be processed. - **APPROVAL_PENDING** Transfer is pending approval. - **PENDING** Transfer is pending processing. - **SENT_TO_CLEARING** Transfer is being processed by the clearing firm. - **REJECTED** Transfer is rejected. - **CANCELED** Client initiated transfer cancellation. - **APPROVED** Transfer is approved. - **COMPLETE** Transfer is completed. - **RETURNED** The bank issued an ACH return for the transfer.
  - `type` 'ach' | 'wire', required — - **ach** Transfer via ACH (US Only). Supports both `INCOMING` (deposit) and `OUTGOING` (withdrawal) directions. - **wire** Transfer via wire. `OUTGOING` (withdrawal) only.
  - `updated_at` string, date-time — Timestamp when transfer was updated

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)