---
title: "Get client profile"
method: GET
path: "/v1/clients/{clientId}"
tags: ["Identity Verification"]
---

# Get client profile

`GET /v1/clients/{clientId}`

Use this endpoint to get the profile of an Identity Verification client, using the Fourthline `clientId`.

## Path parameters

- `clientId` 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.

## Response `200`

Client profile returned

- object
  - `clientId` string — Our unique identifier for the client, returned in your first [Create workflow](https://docs.fourthline.com/reference/create-workflow) request for this client. <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`.
  - `countryCode` string — The code of the client’s country of residence.
  - `clientType` integer — The type of client: <br />• `0`: The client is a natural person. <br />• `1`: The client is a legal entity.
  - `companyName` string — The name of the client’s company.
  - `firstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
  - `lastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
  - `source` string — How the client came in contact with you: <br />• `direct_channel`: The client contacted you directly. <br />• `referral`: The client was referred to you by another client. <br />• `search_engine`: The client found you online via a search engine.
  - `referencedByClientId` string — Your identifier for the other client who referred this client to you.
  - `riskProfile` integer — The client’s [risk score](https://docs.fourthline.com/docs/risk), or if not yet available `0`.
  - `clientStatus` string — The current status of the client: <br />• `new`: The client profile has been created. <br />• `active`: The client was accepted. <br />• `inactive`: The client was rejected.
  - `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
  - `version` string — The version of the client profile. <br />Always returns the value `20171015`.

## Other responses

- `400` — Invalid request parameters
- `404` — Resource 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/versions/7991ae7c8383/schema)