---
title: "List internal transfers"
method: GET
path: "/financial-data/v2beta/internal-transfers"
tags: ["Transactions"]
---

# List internal transfers

`GET /financial-data/v2beta/internal-transfers`

Returns a list of confirmed internal transfers in the organization. For pagination details see the section above.

When the `transactionId` filter is set, the response contains at most one entry — the InternalTransfer that
references the given transaction as either its debit or credit leg. Use this to look up an internal transfer
from a transaction without needing to know which side it represents.

## Query parameters

- `transactionId` string
- `limit` integer
- `token` string

## Response `200`

List of internal transfers.

- object
  - `items` InternalTransfer[], required — A list of resources.
    - `id` string, required — Unique resource identifier.
    - `organizationId` string, required — Unique resource identifier for an Organization.
    - `status` 'CONFIRMED' | 'PENDING', required — CONFIRMED means both legs of the transfer have been observed. PENDING means only one leg has been observed so far — its counterpart's account id is known but the counterpart's transaction id is empty until the counterpart leg ingests.
    - `debitTransactionId` string — Unique resource identifier.
    - `creditTransactionId` string — Unique resource identifier.
    - `debitAccountId` string, required — Unique resource identifier.
    - `creditAccountId` string, required — Unique resource identifier.
    - `created` string, date-time, required — Time at which the resource was created.
    - `updated` string, date-time, required — Time at which the resource was last updated.
    - `version` integer, required — Resource version. Starts at value `1` when the resource is created and increases by one for each successive update.
    - `etag` string, required — [ETag](https://en.wikipedia.org/wiki/HTTP_ETag) based on the resource version. This can be passed along in `If-Match` HTTP header when updating a resource to perform a conditional update.
  - `nextToken` string, required — Pagination token for next page. The value will be a non-empty string if there are more resources to be fetched. The value will be an empty string if there are no more resources to be fetched.
  - `token` string, required — The pagination token that was used for this request. The value will be an empty string if no `token` query parameter was provided with the request.
  - `limit` integer, required — The page limit that was used for this request.

## Other responses

- `400` — Bad request.

---

[API](https://skmtc.net/atlar/apis/atlar-api-v2.md) · [All operations](https://skmtc.net/atlar/apis/atlar-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlar/atlar-api-v2/revisions/9c5e194ccf5d/schema)