---
title: "Mark a user's identity as verified"
method: POST
path: "/v1/user/{userId}/verifyIdentity/"
tags: ["/v1/user"]
---

# Mark a user's identity as verified

`POST /v1/user/{userId}/verifyIdentity/`

## Request

- Base URL: `https://api.counselhealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.counselhealth.com/v1/user/{userId}/verifyIdentity/`
- Auth: HTTP bearer

Marks the user's identity as verified — a one-time transition from unverified to verified. Your organization must be granted the capability to assert identity verification via the API; contact Counsel support to enable it.

  Include the verified demographics — `first_name`, `last_name`, and `dob` — from the completed identity check. Optionally include `middle_name`.

  On success, the response is `verification_status: "verified"` with `id_verified: true`.

  On a mismatch, the response is `verification_status: "mismatch"` with `id_verified: false`

  The call is idempotent: if the user is already verified, the request succeeds without changing the existing verification record. Verification cannot be reverted through this API.

## Path parameters

- `userId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `status` 'verified', required
  - `first_name` string, required
  - `middle_name` string
  - `last_name` string, required
  - `dob` string, required: date of birth in YYYY-MM-DD format (ISO 8601). Must be between 18 and 120 years old
  - `reference` string

## Response `200`

Default Response

- union
  - object
    - `id_verified` true, required
    - `verification_status` 'verified', required
  - object
    - `id_verified` false, required
    - `verification_status` 'mismatch', required

## Other responses

- `400`: 400 error with a machine-readable `code` for client branching.
- `401`: Standard error body returned for non-2xx responses.
- `403`: Standard error body returned for non-2xx responses.
- `404`: Standard error body returned for non-2xx responses.
- `409`: Standard error body returned for non-2xx responses.
- `413`: Standard error body returned for non-2xx responses.
- `429`: Standard error body returned for non-2xx responses.
- `500`: Standard error body returned for non-2xx responses.
- `502`: Default Response
- `503`: Default Response
- `504`: Default Response

---

[API](https://skmtc.dev/counselhealth/apis/counsel-api.md) - [All operations](https://skmtc.dev/counselhealth/apis/counsel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/counselhealth/apis/counsel-api/revisions/4110a89127e8?raw)