---
title: "List transfers"
method: GET
path: "/v1/transfers"
tags: ["standard-transfer"]
---

# List transfers

`GET /v1/transfers`

Get the list of transfers for a given user's profile (defaults to user's personal profile).

You can add query parameters to specify user's profile (personal or business), time period and/or payment status. For example, you can query all failed payments created since last week, or all completed payments created since yesterday.

## Query parameters

- `profile` integer
- `status` string
- `sourceCurrency` string
- `targetCurrency` string
- `createdDateStart` string, date-time
- `createdDateEnd` string, date-time
- `limit` integer
- `offset` integer

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

Returns an array of transfer objects, with or without an `originator` block depending on the type of each transfer.

- union[]
  - union
    - Transfer
      - `id` integer — Transfer ID
      - `user` integer — Your user ID
      - `targetAccount` integer — Recipient account ID
      - `sourceAccount` integer, nullable — Refund recipient account ID
      - `quote` integer, nullable — V1 quote ID
      - `quoteUuid` string, uuid — V2 quote ID
      - `status` string — Transfer current status. See [Tracking Transfers](/guides/product/send-money/tracking-transfers) for all possible statuses.
      - `reference` string — Deprecated, use `details.reference` instead
      - `rate` number — Exchange rate value
      - `created` string, date-time — Timestamp when transfer was created
      - `business` integer, nullable — Your business profile ID
      - `transferRequest` integer, nullable — Deprecated
      - `details` object
        - `reference` string — Payment reference text
      - `hasActiveIssues` boolean — Are there any pending issues which stop executing the transfer?
      - `sourceCurrency` string — Source currency code
      - `sourceValue` number — Transfer amount in source currency
      - `targetCurrency` string — Target currency code
      - `targetValue` number — Transfer amount in target currency
      - `customerTransactionId` string, uuid — Unique identifier randomly generated per transfer request by the calling client
      - `payinSessionId` string, uuid — ID of the Payin Session generated for the transfer, which can be used for certain payin methods when funding the transfer
    - OriginatorTransfer
      - `id` integer — Transfer ID
      - `user` integer — Your user ID
      - `targetAccount` integer — Recipient account ID
      - `sourceAccount` integer, nullable — Refund recipient account ID
      - `quote` string — Quote ID
      - `status` string — Transfer current status. See [Tracking Transfers](/guides/product/send-money/tracking-transfers) for all possible statuses.
      - `reference` string — Deprecated, use `details.reference` instead
      - `rate` number — Exchange rate value
      - `created` string, date-time — Timestamp when transfer was created
      - `business` integer, nullable — Your business profile ID
      - `transferRequest` integer, nullable — Deprecated
      - `details` object
        - `reference` string — Payment reference text
      - `originator` object — Data block to capture payment originator details
        - `legalEntityType` 'PRIVATE' | 'BUSINESS' — Payment originator legal type
        - `reference` string — Unique customer ID in your system
        - `name` object
          - `givenName` string — Payment originator first name
          - `middleNames` string[] — Payment originator middle name(s)
          - `familyName` string — Payment originator family name
          - `patronymicName` string, nullable — Payment originator patronymic name
          - `fullName` string — Payment originator full legal name
        - `dateOfBirth` string, date — Payment originator date of birth
        - `businessRegistrationCode` string, nullable — Payment originator business registry or incorporation number
        - `address` object
          - `firstLine` string — Payment originator address first line
          - `city` string — Payment originator address city
          - `stateCode` string, nullable — Payment originator address state code
          - `countryCode` string — Payment originator address country code ISO 3166-1 alpha-2
          - `postCode` string — Payment originator address zip code
        - `accountDetails` string — Originator account number
      - `hasActiveIssues` boolean — Are there any pending issues which stop executing the transfer?
      - `sourceCurrency` string — Source currency code
      - `sourceValue` number — Transfer amount in source currency
      - `targetCurrency` string — Target currency code
      - `targetValue` number — Transfer amount in target currency
      - `originalTransferId` string — Unique identifier randomly generated per transfer request by the calling client
      - `payinSessionId` string, uuid — ID of the Payin Session generated for the transfer, which can be used for certain payin methods when funding the transfer

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

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