Clients

Clients are a core resource to all ComplyCube services.

A client represents the person or company you will perform on the various checks. To initiate a check, you must first create a client.

The API allows you to create, retrieve, update, and delete your clients. You can retrieve specific clients as well as a list of all your clients.

The Client object

Attribute	Type	Description
id	string	The unique identifier for a client.
type	string	The type of client. Valid values are: person company
entityName	string	The client's full name.
email	string	The client's email address.
mobile	string	The client's mobile number.
telephone	string	The client's telephone number.
externalId	string	A unique identifier that you can associate with the client. For example, this can be the client ID in your system.
joinedDate	string	The date and time when you registered the client. This is relevant for users that migrate existing clients. The format is YYYY-MM-DD.
personDetails	object	Details for a client of type person. Also, see the personDetails object below.
companyDetails	object	Details for a client of type company. Also, see the companyDetails object below.
metadata	object	Set of key-value pairs that you can associate with the client object. This is useful for storing additional information about the client in a structured format. You can specify up to 20 keys, with key names up to 40 characters long and values up to 500 characters long.
createdAt	string	The date and time when the client was created.
updatedAt	string	The date and time when the client was updated.

The personDetails object

Attribute	Type	Description
firstName	string	The client's first name. (Required)
middleName	string	The client's middle name. (Optional)
lastName	string	The client's last name. (Required)
dob	string	The client's date of birth. The format is YYYY-MM-DD. (Optional)
gender	string	The client's gender. Valid values include: male female other (Optional)
nationality	string	The client's nationality. This will be the two-letter country ISO code. (Optional)
birthCountry	string	The client's birth country. This will be the two-letter country ISO code. (Optional)
ssn	string	The client's SSN (Social Security Number). This is for US clients. (Optional)
socialInsuranceNumber	string	The client's Social Insurance Number. (Optional)
nationalIdentityNumber	string	The client's National Identity Number. (Optional)
taxIdentificationNumber	string	The client's Tax Identification Number (TIN). (Optional)

The companyDetails object

Attribute	Type	Description
name	string	The client's name. (Required)
website	string	The client's website. (Optional)
registrationNumber	string	The client's registration or incorporation number. (Optional)
incorporationCountry	string	The client's incorporation country. This will be the two-letter country ISO code. (Optional)
incorporationType	string	The client's incorporation type. Valid values include: sole_proprietorship private_limited_company public_limited_company partnership limited_partnership limited_liability_partnership holding_company non_government_organization non_profit_organization governmental_entity statutory_company subsidiary_company unlimited_partnership unlimited_company trust charitable_incorporated_organization chartered_company cooperative professional_association other (Optional)