--- title: "Create AML client profile" method: POST path: "/v2/clients" tags: ["AML Screening & Monitoring"] --- # Create AML client profile `POST /v2/clients` Use this endpoint to create an AML client profile and upload the client’s data for screening or monitoring.

Important **Important:** Before using this endpoint, see the integration guide. ## Headers - `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response. ## Request body - object - `providerClientId` string, required — Your unique identifier for the client.

Format: No set format

**Tip:** This is the **same** value as your `ClientNumberProvider`. - `clientData` object, required — The client’s identity data. - `person` object, required — The client’s personal data . - `type` 'Natural Person' — The type of client. Set to `Natural Person`. - `name` string — The client’s full name.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: John James Smith - `firstName` string, required — The client’s first name and any middle names.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: `John` - `lastName` string, required — The client’s last name.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: Smith - `nationality` string — The client’s nationality.

Format: ISO 3166-1 alpha-3 country code

Example: BEL - `gender` 'Female' | 'Male' | 'Other' | 'Unknown', required — The client’s sex

Format: Case sensitive
Enum:
• `Female`: Female in line with ID document
• `Male`: Male in line with ID document
• `Other`: ID document contains a value other than `Male` or `Female`
• `Unknown`: ID document contains **no** gender field - `countryOfBirth` string — The country where the client was born.

Format: ISO 3166-1 alpha-3

Example: BEL - `placeOfBirth` string — The city where the client was born.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: Sint-Agatha-Berchem - `birthDate` string, required — The client’s date of birth.

Format: Date YYYY-MM-DD

Example: `1960-10-18`= October 18, 1960 - `address` object — The client’s address details. - `street` string — The street of the client’s address.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: Rue Jean-Baptiste Jansen - `streetNumberPrefix` string — The prefix of the street number

Example: A1 - `streetNumber` integer — The street number of the client’s address.

Format: int32 greater than or equal to zero - `streetNumberSuffix` string — The suffix of the street number.

Format: Alphabetical characters, spaces, hyphens, and numerals

Example: 123A - `postalCode` string — The zip code of the client’s address.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: 1082

**Note**: We use Google’s Address Validation API and depend on the quality of their data - `region` string — The region of the client’s address

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: Brussels Capital Region - `city` string — The city of the client’s address.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: `London` - `country` string — The country of the client’s address.

Format: ISO 3166-1 alpha-3

Example: BEL - `document` object — The client’s ID document data. - `documentNumber` string — The number of the client’s ID document. - `contact` object — The client’s email address and phone number(s). - `email` string — The client’s email address.

Format: Maximum 254 characters [_-a-zA-Z0-9.+]+@a-zA-Z0-9

Example: `j.smith@example.com` - `phone` string — The client’s landline number.

Format: Must include the country code and begin with `00` or `+` **without** spaces

Example: 003281123456 **or** +3281123456 - `mobile` string — The client’s mobile phone number.

Format: Must include the country code and begin with `00` or `+` **without** spaces

Example: `00324123456789` **or** `+324123456789` - `monitoringType` '1' | '2', required — The type of AML client.
Enum:
• `1`: Screening
• `2`: Monitoring - `branch` string — Your configuration for this product.
Set the string provided by your Fourthline delivery manager.
If **not** set, we use your default configuration.

**Tip:** Use this parameter for case configuration in older setups. ## Response `201` The AML client profile was created successfully - object - `id` string — Our unique identifier for the client, returned in the [Create AML client profile](https://docs.fourthline.com/reference/create-aml-client) response.

Format: uuid string

Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` - `providerClientId` string — Your unique identifier for the client.

Format: No set format

**Tip:** This is the **same** value as your `ClientNumberProvider`. - `clientData` object — The client’s identity data. - `person` object — The client’s personal data . - `firstName` string — The client’s first name.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: John - `lastName` string — The client’s last name.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: Smith - `nationality` string — The client’s nationality.

Format: ISO 3166-1 alpha-3 country code

Example: BEL - `gender` string — The client’s sex

Format: Case sensitive
Enum:
• `Female`: Female in line with ID document
• `Male`: Male in line with ID document
• `Other`: ID document contains a value other than `Male` or `Female`
• `Unknown`: ID document contains **no** gender field - `countryOfBirth` string — The country where the client was born.

Format: ISO 3166-1 alpha-3

Example: BEL - `placeOfBirth` string — The city where the client was born.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: Sint-Agatha-Berchem - `birthDate` string — The client’s date of birth.

Format: Date YYYY-MM-DD

Example: `1960-10-18`= October 18, 1960 - `address` object — The client’s address details. - `city` string — The city of the client’s address.

Format: Alphabetical characters, spaces, hyphens, and apostrophes

Example: `London` - `country` string — The country of the client’s address.

Format: ISO 3166-1 alpha-3

Example: BEL - `document` object — The client’s ID document data. - `documentNumber` string — The number of the client’s ID document. - `monitoringType` string — The type of AML client.
Enum:
• `1`: Screening
• `2`: Monitoring - `creationUtcDateTime` string — The timestamp for when the client profile was created

Format: ISO 8601 UTC date and time - `updateUtcDateTime` string — The timestamp for when the client profile was last updated.

Format: ISO 8601 UTC date and time ## Other responses - `400` — Invalid request or validation errors --- [API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/revisions/7991ae7c8383/schema)