GET
/
v2
/
international
/
beneficiaries
List international beneficiaries
curl --request GET \
  --url https://thirdparty.qonto.com/v2/international/beneficiaries \
  --header 'Authorization: Bearer <token>'
{
  "beneficiaries": [
    {
      "id": "0d6273cf-e4d0-469a-a3c8-d2196143470c",
      "name": "John Doe",
      "country": "US",
      "currency": "USD",
      "payment_type": "aba",
      "account_identifier": "123456789",
      "bank_identifier": "AAABBB00",
      "branch_identifier": "123456789"
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": null,
    "prev_page": 1,
    "total_pages": 2,
    "total_count": 150,
    "per_page": 100
  }
}

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.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Query Parameters

​
currency
string
required

The currency of the international beneficiaries to retrieve (ISO 4217 format, alpha 3)

Example:

"EUR"

​
page
string

Returned page (cf. Pagination).

​
per_page
string

Number of beneficiaries per page (cf. Pagination).

Response

200
application/json

Returns international beneficiaries

The response is of type object.