Create Linked Individual

post

https://api-sandbox.merge.money/v1/linked-individual

Create a new linked individual.

This request allows you to create a Linked Individual object. After creating the Linked Individual, its KYC information will be checked and verified.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

main_account_id

string

required

The main account ID for the Linked Individual.

first_name

string

required

The first name of the linked individual.
Max_Length of (first_name + middle_name + last_name) = 140 chars

middle_name

string

The middle name of the linked individual.
Max_Length of (first_name + middle_name + last_name) = 140 chars

last_name

string

required

The last name of the linked individual.
Max_Length of (first_name + middle_name + last_name) = 140 chars

address

object

required

The linked individual's address object.

string

required

The email of the linked individual.
Should be a valid email address.

phone

string

required

The phone number of the linked individual.
Should follow a valid E.164 phone-number format.

date_of_birth

date

required

The date of birth of the linked individual in the YYYY-MM-DD format.

birth_country

string

enum

required

The country of the linked individual’s home address in the two-letter ISO 3166-1 format.

operational_details

object

required

The operational details for the Linked Individual.

salutation

string

enum

The title to be used for the linked individual.

Allowed:

nationalities

array of strings

enum

The nationalities of the linked individual in the two-letter ISO 3166-1 format. You can send multiple nationalities for the linked individual in an array of strings.

nationalities

identification_types

object

The identification_types object

external_ref_id

string

The reference of the linked individual as provided by the associated business.

ip_addresses

array of strings

The IP addresses of the linked individual. For AML check and fraud monitoring, it is recommended to share the list of IP addresses from where the linked individual signed up on the businesses platform.

ip_addresses

professions

string

enum

The profession of the linked individual. For AML check and fraud monitoring, it is recommended to share the profession of the linked client. You can send multiple professions for the Linked Individual in an array of strings.

profession_others_description

string

The description of the linked client's profession. Required when OTHERS in professions.

additional_checks

object

The additional_checks object.

client_nonce

string

The client nonce, which is a random or semi-random number that is used for achieving idempotency. It is strongly recommended that you send this parameter as part of the create request.

alias_name

string

The alias name for Linked Individual.

Responses

201201

400400