Update KYC Personal Details
Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.
Updates the authenticated user’s KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.
Authorizations
API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.
Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.
Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
Headers
A unique request identifier.
"33f4e5af-764c-4624-9d1e-fbbed9bd13ce"
Body
Partial-update payload for KYC personal details. Any subset of these fields may be supplied; omitted fields are left unchanged. The gcid is taken from the authenticated session and is not accepted in the body.
The user's first name.
The user's middle name (optional).
The user's last name.
Gender code. Values: 0=Unspecified, 1=Male, 2=Female, 3=Other.
The user's date of birth (ISO 8601, YYYY-MM-DD).
ISO 3166-1 alpha-2 country code of the user's place of birth.
"US"
ISO 3166-1 alpha-2 country code of the user's primary citizenship.
"US"
A personal identification document (e.g. national ID, passport).
Tax identifications for the user. Supports multiple jurisdictions. When supplied, this replaces the full set of tax identifications on the user record and takes precedence over the deprecated single taxId/taxIdCountry fields. At most one entry may be flagged primary; at most 10 entries; one entry per country.
Deprecated. Use taxIds[]. Accepted only when taxIds[] is absent. Retained for backward compatibility.
Deprecated. Use taxIds[]. ISO 3166-1 alpha-2 country code of the deprecated single tax identification. Retained for backward compatibility.
"DE"
A secondary citizenship held by the user.
Response
KYC personal details updated successfully. Returns the full personal-details record after the update.
Full KYC personal-details record for the authenticated user.
The user's global customer identifier.
The user's first name.
The user's middle name (optional).
The user's last name.
Gender code. Values: 0=Unspecified, 1=Male, 2=Female, 3=Other.
The user's date of birth (ISO 8601, YYYY-MM-DD).
ISO 3166-1 alpha-2 country code of the user's place of birth.
"US"
ISO 3166-1 alpha-2 country code of the user's primary citizenship.
"US"
A personal identification document (e.g. national ID, passport).
All tax identifications held by the user, one entry per issuing country.
Deprecated. Use taxIds[]. Mirrors the primary tax identification number. Retained for backward compatibility.
Deprecated. Use taxIds[]. ISO 3166-1 alpha-2 country code of the primary tax identification. Retained for backward compatibility.
"DE"
A secondary citizenship held by the user.