---
title: "Update AML client"
method: PUT
path: "/v2/clients/{id}"
tags: ["AML Screening & Monitoring"]
---

# Update AML client

`PUT /v2/clients/{id}`

Use this endpoint to update an AML client profile.

## Path parameters

- `id` string, required

## 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
  - `clientData` object, required — The client’s <Glossary>identity data</Glossary>.
    - `person` object, required — The client’s <Glossary>personal data</Glossary> .
      - `type` 'Legal Entity' | 'Legal Person' | 'Natural Person' — The type of entity the client is. <br />Enum: <br />• `Legal Entity`: The client is a company or organization with legal rights and obligations. <br />• `Legal Person`: The client is a non-human entity with legal rights and obligations. <br />• `Natural Person`: The client is a living human.
      - `name` string — The client’s full name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John James Smith
      - `initials` string — The client’s initials. <br /><br />Format: Alphabetical characters <br /><br />Example: JCCF
      - `firstName` string, required — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
      - `middleName` string — The client’s middle name(s). <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: James
      - `lastName` string, required — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
      - `nationality` string, required — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
      - `gender` 'Female' | 'Male' | 'Other' | 'Unknown', required — The client’s sex <br /><br />Format: Case sensitive <br />Enum: <br />• `Female`: Female in line with ID document <br />• `Male`: Male in line with ID document <br />• `Other`: ID document contains a value other than `Male` or `Female` <br />• `Unknown`: ID document contains **no** gender field
      - `countryOfBirth` string — The country where the client was born. <br /><br />Format: ISO 3166-1 alpha-3 <br /><br />Example: BEL
      - `placeOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
      - `birthDate` string, required — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
    - `address` object, required — The client’s address details.
      - `street` string — The street of the client’s address. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Rue Jean-Baptiste Jansen
      - `streetNumberPrefix` string — The prefix of the street number <br /><br />Example: A1
      - `streetNumber` integer — The street number of the client’s address. <br /><br />Format: int32 greater than or equal to zero
      - `streetNumberSuffix` string — The suffix of the street number. <br /><br />Format: Alphabetical characters, spaces, hyphens, and numerals <br /><br />Example: 123A
      - `postalCode` string — The zip code of the client’s address. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: 1082 <br /><br /><img src="https://files.readme.io/ad2486a-Inline_Note.svg" align="left"/>**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 <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Brussels Capital Region
      - `city` string, required — The city of the client’s address. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: `London`
      - `country` string, required — The country of the client’s address. <br /><br />Format: ISO 3166-1 alpha-3 <br /><br />Example: BEL
    - `document` object, required — The client’s ID document data.
      - `documentNumber` string — The number of the client’s <Glossary>ID document</Glossary>.
    - `contact` object, required — The client’s email address and phone number(s).
      - `email` string — The client’s email address. <br /><br />Format: Maximum 254 characters [_-a-zA-Z0-9.+]+@a-zA-Z0-9 <br /><br />Example: `j.smith@example.com`
      - `phone` string — The client’s landline number. <br /><br />Format: Must include the country code and begin with `00` or `+` **without** spaces <br /><br />Example: 003281123456 **or** +3281123456
      - `mobile` string — The client’s mobile phone number. <br /><br />Format: Must include the country code and begin with `00` or `+` **without** spaces <br /><br />Example: `00324123456789` **or** `+324123456789`
  - `monitoringType` string — The type of AML client. <br />Enum: <br />• `1`: Screening <br />• `2`: Monitoring

## Response `200`

AML client updated

## Other responses

- `400` — Invalid request parameters

---

[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)