The Linked Individual Object

A linked individual represents your end-user of type person who can be onboarded on the Merge platform. The KYC information of the Linked Individual is checked and verified. After successful verification, you can open a bank account in the name of the linked individual i.e. John Smith. This linked individual account can hold fund balance, accept deposits and issue payouts to registered beneficiaries.

id string
The unique identifier (UUID) of the linked individual.
Example: af221980-450b-11ed-b878-0242ac120002

company_id string
The unique identifiquer (UUID) of the company to which the linked inidividual is associated.
Example: 10e0c33b-e122-4ce2-b279-c21b992c21bf

created_at timestamp
The ISO 8601 timestamp at which the linked client was created.
Example: 2023-07-18T12:08:53.107162+00:00

updated_at timestamp
The ISO 8601 timestamp at which the linked client was updated.
Example: 2023-07-18T12:08:53.107162+00:00

alias_id string
This unique identifier is of shorter length and could be used to raise customer support queries.
Example: MLI123456789012

client_status string
The status of the linked individual.
Possible values: IN-REVIEW, ON-HOLD, ACTIVE, INACTIVE, SUSPENDED, or CLOSED

client_kyc_status string
The KYC verification status of the linked individual.
Possible values: PENDING, INITIATED, ON-HOLD, INVALID_DATA, VERIFIED, REJECTED, or CLIENT_VERIFIED

type string
The type of linked member.
Possible values: individual or business

first_name string
The first name of the linked individual.
Example: John

middle_name string
The middle name of the linked individual.
Example: M

last_name string
ThelLast name of the linked individual.
Example: Smith

alias_name string
The alias name by which the linked individual is identified on the Merge platform.
Example: Johnny

address object

Specifies the address object.

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

city string
The city or town of the linked individual’s home address.
Example: London

postcode string
The postal code of the linked individual's home address.
Example: E1 6AN

line1 string
The first line of the linked individual’s home address.
Example: 829 Bell Journey

line2 string
The second line of the linked individual’s home address.
Example: Apartment 3

state string
The state of the linked individual’s home address.

email string
The linked individual's email.
Example: [email protected]

birth_country string
The birth country of the linked individual’s home address in the two-letter ISO 3166-1 format.
Example: GB

date_of_birth date
The date of birth of the linked individual in the YYYY-MM-DD format.
Example: 1975-01-01

phone date
The phone number of the linked individual.
Example: +332839590006

metadata key-value set
Any additional data for the linked individual.

salutation enum
The salutation of the linked individual.
Possible values: Mr., Ms., Miss, Mrs., Dr., or Mx.

external_ref_id string
Reference identifier of the linked member provided by the business.
Example: 10e0c33b-e122-4ce2-b279-c21b992c21bf

professions array of strings
The profession of the linked individual. For AML check and fraud monitoring, it is recommended to share the correct profession.

identification_types object

The allowed identification documents for the linked individual.

passport string
The passport number of the linked individual.
Example: 363916001

driver_licence string
The driver’s licence of the linked individual.
Example: 7221702

national_id string
National id of the linked individual.
Example: 20-10563145-8

nationalities array of strings
The nationalities of the linked individual in the two-letter ISO 3166-1 format
Example: GB

ip_addresses array of strings
The IP addresses of the linked individual. For AML check and fraud monitoring, it is recommended to share the correct list of IP addresses from where the end-user signed up on the businesses platform.
Example: 192.168.0.1

profession_others_description array of strings
The description of the linked individual's profession.

additional_checks object

The additional checks to be executed for the linked individual. For risk monitoring, it is recommended to confirm if the linked client is a politically exposed person.

pep boolean
For risk monitoring it is recommended to confirm if the linked client is a politically exposed person. If set to True additional checks will be performed.

sanctions_list boolean
For risk monitoring it is recommended to confirm if the linked client is on the sanctions list. If set to True additional checks will be performed.

adverse_media boolean
For risk monitoring it is recommended to confirm if the linked client is in adverse media. If set to True additional checks will be performed.