Skip to main content
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", "legal_type": "LEGAL_TYPE_COMPANY", "owned_by_customer": false, "bank_identifier": "AAABBB00", "branch_identifier": "123456789" } ], "meta": { "current_page": 2, "next_page": 3, "prev_page": 1, "total_pages": 11, "total_count": 210, "per_page": 20 } }

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

Returns international beneficiaries

beneficiaries
object[]
meta
object

Metadata for paginated responses