# Clients A **client** (or customer) represents the individual or company you want to verify. Before running any checks, you must first create a client record. The API allows you to create, retrieve, update, and delete clients. You can fetch a specific client or retrieve 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 50 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)

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.complycube.com/documentation/api-reference/core-resources/clients.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.