Skip to main content
GET
Get a beneficiary
Get a single beneficiary by beneficiary ID

Authorizations

x-api-key
string
header
required

An API Key.

Headers

Authorization
string
required

The access token.

X-Contact-ID
string

The identifier of a contact.

Path Parameters

beneficiary_id
string
required

The identifier of a beneficiary.

Query Parameters

client_id
string
required

The identifier of a client.

Response

The data of a beneficiary.

The data of a beneficiary.

active
boolean
required

True if beneficiary is active, False otherwise.

aml_status
enum<string>
required

AML status of the beneficiary.

Available options:
OK,
Pending Review,
Pending information,
Blocked
bank_accounts
object[]
required

The list of beneficiary's bank accounts.

beneficiary_id
string
required

The identifier of the beneficiary.

created
string<date>
required

Creation date of the beneficiary.

address_line_1
string

The first address line of the beneficiary.

beneficiary_reference
string

The reference for the beneficiary.

country_code
string

The ISO 3166-1 alpha-2 code of the beneficiary's country.

Pattern: [A-Z]{2}
email_addresses
string<email>[]

The list of beneficiary's email addresses.

email_notification
boolean

Whether the beneficiary should receive email notification of payments.

name
string

The name of the beneficiary.

post_code
string

The post code of the beneficiary.