---
title: "List Account Transfers"
method: GET
path: "/account_transfers"
---

# List Account Transfers

`GET /account_transfers`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `account_id` string — Filter Account Transfers to those that originated from the specified Account.
- `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.

## Response `200`

Account Transfer List

- AccountTransferList — A list of Account Transfer objects.
  - `data` AccountTransfer[], required — The contents of the list.
    - `account_id` string, required — The Account from which the transfer originated.
    - `amount` integer, required — The transfer amount in cents. This will always be positive and indicates the amount of money leaving the originating account.
    - `approval` object, nullable, required — If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.
      - `approved_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was approved.
      - `approved_by` string, nullable, required — If the Transfer was approved by a user in the dashboard, the email address of that user.
    - `cancellation` object, nullable, required — If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.
      - `canceled_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Transfer was canceled.
      - `canceled_by` string, nullable, required — If the Transfer was canceled by a user in the dashboard, the email address of that user.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created.
    - `created_by` object, nullable, required — What object created the transfer, either via the API or the dashboard.
      - `api_key` object, nullable — If present, details about the API key that created the transfer.
        - `description` string, nullable, required — The description set for the API key when it was created.
      - `category` 'api_key' | 'oauth_application' | 'user', required — The type of object that created this transfer.
      - `oauth_application` object, nullable — If present, details about the OAuth Application that created the transfer.
        - `name` string, required — The name of the OAuth Application.
      - `user` object, nullable — If present, details about the User that created the transfer.
        - `email` string, required — The email address of the User.
    - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's currency.
    - `description` string, required — An internal-facing description for the transfer for display in the API and dashboard. This will also show in the description of the created Transactions.
    - `destination_account_id` string, required — The destination Account's identifier.
    - `destination_transaction_id` string, nullable, required — The identifier of the Transaction on the destination Account representing the received funds.
    - `id` string, required — The Account Transfer's identifier.
    - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `pending_transaction_id` string, nullable, required — The ID for the pending transaction representing the transfer. A pending transaction is created when the transfer [requires approval](https://increase.com/documentation/transfer-approvals#transfer-approvals) by someone else in your organization.
    - `status` 'pending_approval' | 'canceled' | 'complete', required — The lifecycle status of the transfer.
    - `transaction_id` string, nullable, required — The identifier of the Transaction on the originating account representing the transferred funds.
    - `type` 'account_transfer', required — A constant representing the object's type. For this resource it will always be `account_transfer`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api.md) · [All operations](https://skmtc.net/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api/versions/22125d715935/schema)