Skip to main content
PATCH
Update Customer Identification Data

Authorizations

X-API-Key
string
header
required

API Key

Headers

X-SUB-PARTNER-ID
string

Optional sub-partner UUID, if provided, the identification data will be updated for the sub-partner's customer

X-API-Version
string

Selects the API version for this request, as an ISO date (YYYY-MM-DD). Omit to use the default version (2025-03-13). Supported versions: 2025-03-13, 2026-07-01, 2026-08-01.

Path Parameters

id
string<uuid>
required

the ID of the Customer whose identification data will be updated

Body

application/json; charset=utf-8

The identification data to update

Update Identification Data Params

Partial update for a person customer's existing KYC record. Only non-null fields are applied; today only the tax identification number is supported.

tax_identification_number
string

Tax identification number (e.g. SSN for US, national TIN for EEA residents). Patched directly onto the customer's existing KYC record — does not trigger re-verification, so an already-approved customer's status is unaffected.

tax_residence_country
string

ISO 3166-1 alpha-2 country of tax residence. Required whenever tax_identification_number is set — TIN format is validated against this specific country, and it can genuinely differ from the customer's physical residence or nationality (the reason DAC8/CARF asks for it separately).

Response

PATCH Customer Identification Data Succeeded

Identification

The entity wrapping our KYC/KYB process and underlying providers

created_at
string<date-time>
required
id
string<uuid>
required
status
enum<string>
required

The Process status of the identification

The various state transitions an identification can go through.

Available options:
Pending,
Processed,
PendingReview,
Approved,
Declined,
Expired,
Archived
updated_at
string<date-time>
required
customer_id
string<uuid>

Absent on a referral partner's identification (partner-keyed record)

partner_id
string<uuid>

The owning partner for partner-keyed (referral) records

residence_country
string

ISO 3166-1 alpha-2 (2 letter) country code of the verified residence address; only set on the customer's most recent identification while it is approved

review_comment
string
step_status
BusinessIdentificationStepStatus · object
url
string
with_edd
boolean