---
title: "List external transfers"
method: GET
path: "/v2/external_transfers"
tags: ["External Transfers"]
---

# List external transfers

`GET /v2/external_transfers`

OAuth scope: `organization.read`

---
Retrieve a list of external transfers.

---

## Attributes details

##### Initiator ID
ID of the membership that initiated the external transfer.
<br>When the external transfer is initiated through the API, the initiator is the authenticated membership.

##### Debit
- `debit_iban`: Can be any of the organization's bank accounts. IBAN formatted ISO 13616.
- `debit_amount`: The amount that will be debited from your Qonto account.
- `debit_amount_cents`: The amount that will be debited from you Qonto account in an integer format.
- `debit_currency`: Must be EUR. ISO 4217 formatted.

##### Credit
- `credit_amount`: The amount that the beneficiary will receive.
- `credit_amount_cents`: The amount that the beneficiary will receive in an integer format.
- `credit_currency`: Equals debit currency if issued in the SEPA network (only supported currencies). ISO 4217 format. Allowed value for international transfers: AUD, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, ILS, JPY, NOK, NZD, PLN, RON, SEK, USD

##### FX rate
- `rate_applied`: Foreign exchange rate applied to your transaction, formatted with 4 digits after comma. Ex: 1,1082

#### Timestamps

Each external transfer contains three timestamps:

* `created_at`, UTC, the time at which the external transfer was first recorded.
* `processed_at`, UTC, when the external transfer has been started to be processed by Qonto.
* `completed_at`, UTC, when the external transfer is in its final state, either settled or declined.
* `scheduled_date`, YYYY-MM-DD, indicates when the external transfer was scheduled to be sent by Qonto.

##### Status
`status` can contain the following values

* `pending`: External transfer is created and has not been processed yet. If transfer is not processed within next minute, it means either execution date may not been reached yet or we are running some compliance checks on this transfer.
* `processing`: External transfer processing means account balance is debited and a transaction has been created. Processing status can last up to multiple hours until transfer is sent in the network to the beneficiary.
* `canceled`: When the external transfer is canceled by a user in the interface. This is a permanent status.
* `declined`: When the external transfer is declined by the screening service, fraud service or, once sent on the network, for many various reasons which are listed in [those guidelines](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2023-11/EPC135-18%20v5.0%20Guidance%20on%20Reason%20Codes%20for%20SCT%20R-transactions.pdf). This is a permanent status.
* `settled`: When the external transfer is sent to the network, transfer is settled. This is a permanent status.

## Filters

#### `status`
External transfers can be filtered by status. The `status` query parameter accepts an array of statuses as value. The possible values are: `pending`, `processing`, `canceled`, `declined` and `settled`.

For example, if you want to retrieve several External Transfers statuses, you can use the following filter: `status[]=processing&status[]=declined&status[]=settled`

#### `beneficiary_ids`
Allows filtering on a list of beneficiary IDs


#### `updated_at` / `scheduled_date`
External transfers can be filtered according to both `updated_at` and `scheduled_date` fields.
This is particularly useful to retrieve only the latest external transfers in your application.
Two filters are available :

- **updated_at**
  - `updated_at_from`: Minimum value (e.g: `2019-01-10T11:47:53.123Z`)
  - `updated_at_to`: Maximum value
- **scheduled_date**
  - `scheduled_date_from`: Minimum value
  - `scheduled_date_to`: Maximum value

**Do note**:

- *You can use one or the other `updated_at` filter (same for `scheduled_date`), or use them in combination if you want external transfers updated within a specific timeframe.*
- *`updated_at` / `scheduled_date` filters should have a valid date time format (**ISO 8601** for instance)*

## Sorting

External transfers can be sorted by a specific field and order. The `sort_by` query parameter accepts a string defining these two items with the `field:order` format.

#### Field

- `scheduled_date` and `updated_at` values are available.

#### Order

- Two values are available : `asc` (Ascending) / `desc` (Descending)
- By default the order used to sort external transfers is `desc`

**Do note**: You can use a combination of field and order to define how to sort external transfers:
- Only field (e.g `updated_at`, order will have default value `desc`)
- Only order (e.g `:asc`, field will have default value `updated_at`)
- Both (e.g `updated_at:asc`)

## Query parameters

- `status` string[]
- `updated_at_from` string
- `updated_at_to` string
- `scheduled_date_from` string
- `scheduled_date_to` string
- `beneficiary_ids` string[]

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

lists external transfers

- object
  - `external_transfers` ExternalTransfer[]
    - `id` string, uuid, required
    - `slug` string, required
    - `debit_iban` string, required — ISO 13616
    - `debit_amount` string, required
    - `debit_amount_cents` string, required
    - `debit_currency` string, required — ISO 4217
    - `beneficiary_id` string, uuid, required
    - `initiator_id` string, uuid, required — ID of the membership that initiated the external transfer. <br>When the external transfer is initiated through the API, the initiator is the authenticated membership.
    - `credit_amount` string, required
    - `credit_amount_cents` string, required
    - `credit_currency` string, required — ISO 4217
    - `rate_applied` string
    - `payment_purpose` string — Compulsory for all swift networks
    - `reference` string, required
    - `note` string — 140 characters max
    - `declined_reason` string — Populated only when transfer **status** is declined. Possible values: `beneficiary_bic_invalid` `beneficiary_iban_invalid` `beneficiary_status` `beneficiary_network_rules_error` `organisation_compliance_reasons` `debit_account_insufficient_funds` `qonto_processing_failed`
    - `status` string, required — Possible values: `pending` `processing` `canceled` `declined` `settled`
    - `scheduled_date` string, required
    - `created_at` string, required
    - `completed_at` string
    - `processed_at` string
    - `transaction_id` string, uuid
  - `meta` Pagination
    - `current_page` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

- `422` — Returns errors

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)