---
title: "Update an identification document"
method: PUT
path: "/v1/profiles/{profileId}/verification-documents"
tags: ["profile"]
---

# Update an identification document

`PUT /v1/profiles/{profileId}/verification-documents`

Update an existing identification document on a personal profile. Not
applicable to business profiles.

This endpoint performs a full replacement of the document details. Any
fields not provided in the request body will be set to null on the stored
document. Partners must provide all fields they wish to retain. 

Only partners with a KYC partner onboarding model
are permitted to use this endpoint. Non-KYC partners will receive a 400 error.

## Path parameters

- `profileId` integer, required

## Headers

- `X-External-Correlation-Id` string, uuid

## Request body

- object
  - `clientId` string, required — The partner's client ID.
  - `firstName` string — Person first name in document.
  - `lastName` string — Person last name in document.
  - `type` 'DRIVERS_LICENCE' | 'IDENTITY_CARD' | 'GREEN_CARD' | 'MY_NUMBER' | 'PASSPORT' | 'SSN' | 'EMIRATES_EMPLOYER' | 'EMIRATES_PLACE_OF_BIRTH' | 'CPF_CNPJ' | 'FINANCIAL_CAPACITY_BR' | 'OTHER', required — Document type.
  - `uniqueIdentifier` string — Document number or value. Must be digits only when SSN or FINANCIAL_CAPACITY_BR.
  - `issueDate` string — Document issue date.
  - `issuerCountry` string — Issued by country code. For example "US".
  - `issuerState` string — Issued by state code. For example "NY".
  - `expiryDate` string — Document expiry date.
  - `nationality` string — 2 characters ISO country code.
  - `sex` 'MALE' | 'FEMALE' — Sex as stated in the document.
  - `placeOfBirth` string — Place of birth as stated in the document.

## Response `200`

Identification document updated successfully.

- object
  - `errorMessage` string, nullable
  - `success` boolean

## Other responses

- `400` — Validation error. Possible error codes: - `not.allowed.for.clientId` — Partner is not found or is not a KYC partner. - `not.allowed.for.uniqueIdentifier` — Document number exceeds maximum length (30 characters). - `NotNull` — A required field (`type` or `clientId`) is missing.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)