---
title: "Get AML client by your ID"
method: GET
path: "/v2/clients/ProviderClientId/{providerClientId}"
tags: ["AML Screening & Monitoring"]
---

# Get AML client by your ID

`GET /v2/clients/ProviderClientId/{providerClientId}`

Use this endpoint to get an AML client profile using **your** identifier: `providerClientId`.

## Path parameters

- `providerClientId` string, required

## Query parameters

- `tenant` string

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.
- `Cache-Control` string

## Response `200`

AML client returned

- 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. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
  - `providerClientId` string — Your unique identifier for the client. <br /><br />Format: No set format <br /><br /> <img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>**Tip:** This is the **same** value as your `ClientNumberProvider`.
  - `clientData` object — The client’s <Glossary>identity data</Glossary>.
    - `person` object — The client’s <Glossary>personal data</Glossary> .
      - `type` string — The type of AML client. <br />Enum: <br />• `1`: Screening <br />• `2`: Monitoring
      - `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 — 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 — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
      - `nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
      - `gender` string — 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 — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
    - `address` object — 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: `NW1 6XE`
      - `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 — The city of the client’s address. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: `London`
      - `country` string — The country of the client’s address. <br /><br />Format: ISO 3166-1 alpha-3 <br /><br />Example: BEL
    - `contact` object — 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`
    - `document` object
      - `documentNumber` string — The number of the client’s <Glossary>ID document</Glossary>.
  - `monitoringType` string — The type of AML client. <br />Enum: <br />• `1`: Screening <br />• `2`: Monitoring
  - `creationUtcDateTime` string — The timestamp for when the client profile was created <br /><br />Format: ISO 8601 UTC date and time
  - `updateUtcDateTime` string — The timestamp for when the client profile was last updated. <br /><br />Format: ISO 8601 UTC date and time

## Other responses

- `404` — AML client not found

---

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