---
title: "List Transfers for a User"
method: GET
path: "/v1/transfers"
tags: ["Transfers"]
---

# List Transfers for a User

`GET /v1/transfers`

> 📘
>
> You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.

Retrieve all Transfers for a User.

> 📘
>
> This resource returns paginated results in descending order.  For more details please see: [Pagination](https://docs.astra.finance/reference/pagination)

## Query parameters

- `status` string
- `source_id` string
- `page_size` integer
- `cursor_id` string
- `batch_id` string
- `batch_type` 'credit' | 'debit'

## Response `200`

Successful response

- object
  - `count` integer — The number of transfers returned
  - `transfers` object[]
    - `id` string — The unique ID of the transfer
    - `routine_type` 'one-time' | 'recurring' — The type of routine associated with the transfer
    - `routine_name` string — The name of the routine associated with the transfer
    - `routine_id` string — The unique ID of the routine associated with the transfer
    - `client_correlation_id` string — An optional correlation id that will be added to ACH or Debit Addenda. This will also be included in the Transfer response.
    - `source_id` string — The ID of the Source Account
    - `destination_id` string — The ID of the Destination Account
    - `destination_user_id` string — The User ID associated with the Destination Account (if peer-to-peer)
    - `amount` number, float — The amount of the transfer (when explicitly defined like one-time or recurring)
    - `payment_type` 'ach' | 'debit' | 'ledger' — The type of payment
    - `initiated` string, date-time — The date and time the transfer was initiated
    - `net_credit_batch_id` string — The Net Credit Batch Transfer ID associated with this transfer
    - `net_debit_batch_id` string — The Net Debit Batch Transfer ID associated with this transfer
    - `updated` string, date-time — The date and time the transfer was updated
    - `estimated_clearing_date` string, date-time — The estimated date and time the transfer will clear
    - `astra_settlement_reason` string — The reason that an estimated settlement date may have been changed
    - `failure_reason` string — The reason that astra transfer was not successful
    - `status` 'pending' | 'processed' | 'cancelled' | 'failed' — The status of the Transfer
    - `ultimate_receiver_id` string — The User ID of the ultimate receiver of the Transfer
    - `ultimate_sender_id` string — The User ID of the ultimate sender of the Transfer
  - `next_cursor_id` string — The next cursor ID, for resuming a paginated query
  - `has_next_page` boolean — Whether the paginated query has additional pages (value may be null if no there are no additional pages)

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/astra/apis/astra-developer-api.md) · [All operations](https://skmtc.net/astra/apis/astra-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astra/astra-developer-api/revisions/09f0430e5d33/schema)