List external transfers

curl --request GET \
  --url https://thirdparty.qonto.com/v2/external_transfers \
  --header 'Authorization: Bearer <token>'

{
  "external_transfers": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "slug": "<string>",
      "debit_iban": "<string>",
      "debit_amount": "12.55",
      "debit_amount_cents": "1255",
      "debit_currency": "EUR",
      "beneficiary_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "credit_amount": "<string>",
      "credit_amount_cents": "<string>",
      "credit_currency": "<string>",
      "reference": "<string>",
      "status": "pending",
      "scheduled_date": "2021-07-12",
      "created_at": "2021-01-27T22:05:07.000Z",
      "rate_applied": "<string>",
      "payment_purpose": "goods",
      "note": "<string>",
      "declined_reason": "beneficiary_bic_invalid",
      "completed_at": "2021-01-27T22:05:07.000Z",
      "processed_at": "2021-01-27T22:05:07.000Z",
      "transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

GET

external_transfers

List external transfers

curl --request GET \
  --url https://thirdparty.qonto.com/v2/external_transfers \
  --header 'Authorization: Bearer <token>'

{
  "external_transfers": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "slug": "<string>",
      "debit_iban": "<string>",
      "debit_amount": "12.55",
      "debit_amount_cents": "1255",
      "debit_currency": "EUR",
      "beneficiary_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "credit_amount": "<string>",
      "credit_amount_cents": "<string>",
      "credit_currency": "<string>",
      "reference": "<string>",
      "status": "pending",
      "scheduled_date": "2021-07-12",
      "created_at": "2021-01-27T22:05:07.000Z",
      "rate_applied": "<string>",
      "payment_purpose": "goods",
      "note": "<string>",
      "declined_reason": "beneficiary_bic_invalid",
      "completed_at": "2021-01-27T22:05:07.000Z",
      "processed_at": "2021-01-27T22:05:07.000Z",
      "transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Response

Returns the list of external transfers for the authenticated organization.

external_transfers

object[]

required

Show child attributes

external_transfers.id

string<uuid>

required

this is a description

external_transfers.slug

string

required

external_transfers.debit_iban

string

required

Can be any of the organization's bank accounts. IBAN formatted ISO 13616.

external_transfers.debit_amount

string

required

The amount that will be debited from your Qonto account.

Example:

"12.55"

external_transfers.debit_amount_cents

string

required

The amount that will be debited from you Qonto account in an integer format.

Example:

"1255"

external_transfers.debit_currency

string

required

Must be EUR. ISO 4217 formatted.

Example:

"EUR"

external_transfers.beneficiary_id

string<uuid>

required

external_transfers.initiator_id

string<uuid>

required

ID of the membership that initiated the external transfer.
When the external transfer is initiated through the API, the initiator is the authenticated membership.

external_transfers.credit_amount

string

required

The amount that the beneficiary will receive.

external_transfers.credit_amount_cents

string

required

The amount that the beneficiary will receive in an integer format.

external_transfers.credit_currency

string

required

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.

external_transfers.reference

string

required

external_transfers.status

string

required

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. This is a permanent status.
settled: When the external transfer is sent to the network, transfer is settled. This is a permanent status.

Example:

"pending"

external_transfers.scheduled_date

string

required

YYYY-MM-DD, indicates when the external transfer was scheduled to be sent by Qonto.

Example:

"2021-07-12"

external_transfers.created_at

string

required

UTC, the time at which the external transfer was first recorded

Example:

"2021-01-27T22:05:07.000Z"

external_transfers.rate_applied

string

Foreign exchange rate applied to your transaction, formatted with 4 digits after comma. Ex: 1,1082

external_transfers.payment_purpose

string

Compulsory for all swift networks

Example:

"goods"

external_transfers.note

string

140 characters max

external_transfers.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

Example:

"beneficiary_bic_invalid"

external_transfers.completed_at

string

UTC, when the external transfer is in its final state, either settled or declined.

Example:

"2021-01-27T22:05:07.000Z"

external_transfers.processed_at

string

UTC, when the external transfer has been started to be processed by Qonto.

Example:

"2021-01-27T22:05:07.000Z"

external_transfers.transaction_id

string<uuid>

Retrieve an external transfer Create an external transfer for a trusted beneficiary

⌘I

Business API

Onboarding API

List external transfers

Authorizations

Response