Core API
- Concepts
- Authentication
- Countries
- Users
- KYC
- Introduction
- GETGet overview
- PATCHUpdate email
- PATCHUpdate phone
- PATCHUpdate profile
- PATCHUpdate address
- PATCHUpdate identity
- PATCHUpdate proof of address
- PATCHUpdate customer due diligence
- PATCHUpdate enhanced due diligence
- PATCHUpdate crypto risk assessment
- PATCHUpdate self-categorization statement
- PATCHUpdate tax details
- Webhooks
- Capabilities
- Terms of Service
- Files
- Assets
- Accounts
- External Accounts
- Transactions
- Webhooks
Widgets API
- Payment
Update identity
Update the identity process for a user.
curl --request PATCH \
--url https://api.enterprise.sandbox.uphold.com/core/kyc/processes/identity \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"input": {
"media": [
{
"context": "photo-selfie",
"fileId": "470b2192-893f-4ce6-9daa-816d4c319a84"
}
]
},
"output": {
"provider": "veriff",
"document": {
"type": "passport",
"number": "7700225VH",
"country": "GB",
"expiresAt": "2026-03-13"
},
"person": {
"givenName": "John",
"familyName": "Doe",
"birthdate": "1987-09-04",
"gender": "male"
},
"verifiedAt": "2020-01-01T00:00:00Z"
}
}'
{
"identity": {
"status": "ok",
"input": {
"media": [
{
"context": "photo-selfie",
"fileId": "470b2192-893f-4ce6-9daa-816d4c319a84"
}
]
},
"output": {
"provider": "veriff",
"document": {
"type": "passport",
"number": "7700225VH",
"country": "GB",
"expiresAt": "2026-03-13"
},
"person": {
"givenName": "John",
"familyName": "Doe",
"birthdate": "1987-09-04",
"gender": "male",
"address": {
"country": "GB",
"subdivision": "GB-MAN",
"city": "Manchester",
"line1": "1 High Street",
"line2": "Northern Quarter",
"postalCode": "M4 1AA"
}
},
"verifiedAt": "2020-01-01T00:00:00Z"
}
}
}
The identity is a process where the user proves who they say they are, via an official document such as a government issued ID card or a passport. Moreover, the user may be susceptible to taking selfies to further check if the person on the document is the same as the one going through the process.
Media files
There are media files required for the identity verification process that must be passed as input.media
.
The following table lists the supported contexts and their respective file categories.
The front side of the photo document.
File Category: image
The back side of the photo document.
File Category: image
A selfie of the user.
File Category: image
A selfie of the user holding the photo document.
File Category: image
A recording of the user going through the process of taking pictures.
File Category: video
Authorizations
OAuth 2.0 authentication.
Body
Output of the KYC process.
The provider used to verify the KYC process.
The identity document information.
The type of the document.
driving-license
, id-card
, passport
, residence-permit
The number of the document.
The country of the address.
The expiration date of the document.
The person information.
The person's given name.
200
The date of birth.
The person's family name or surname.
200
The gender.
female
, male
The address information.
The country of the address.
The subdivision of the address.
The city of the address.
The first line of the address.
The second line of the address.
The postal code of the address.
The date and time of the verification.
Response
Status of the KYC process.
ok
, failed
, running
, pending
, exempt
Input of the KYC process.
Output of the KYC process.
The provider used to verify the KYC process.
The identity document information.
The type of the document.
driving-license
, id-card
, passport
, residence-permit
, unsupported
The number of the document.
The country of the document.
The expiration date of the document.
The person information.
The person's given name.
The date of birth.
The person's family name or surname.
The gender.
female
, male
The address information.
The country of the address.
The subdivision of the address.
The city of the address.
The first line of the address.
The second line of the address.
The postal code of the address.
The date and time of the verification.
The reason associated with the verification.
data-mismatch
, duplicate
, fraud
, missing-declared-information
, underage
curl --request PATCH \
--url https://api.enterprise.sandbox.uphold.com/core/kyc/processes/identity \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"input": {
"media": [
{
"context": "photo-selfie",
"fileId": "470b2192-893f-4ce6-9daa-816d4c319a84"
}
]
},
"output": {
"provider": "veriff",
"document": {
"type": "passport",
"number": "7700225VH",
"country": "GB",
"expiresAt": "2026-03-13"
},
"person": {
"givenName": "John",
"familyName": "Doe",
"birthdate": "1987-09-04",
"gender": "male"
},
"verifiedAt": "2020-01-01T00:00:00Z"
}
}'
{
"identity": {
"status": "ok",
"input": {
"media": [
{
"context": "photo-selfie",
"fileId": "470b2192-893f-4ce6-9daa-816d4c319a84"
}
]
},
"output": {
"provider": "veriff",
"document": {
"type": "passport",
"number": "7700225VH",
"country": "GB",
"expiresAt": "2026-03-13"
},
"person": {
"givenName": "John",
"familyName": "Doe",
"birthdate": "1987-09-04",
"gender": "male",
"address": {
"country": "GB",
"subdivision": "GB-MAN",
"city": "Manchester",
"line1": "1 High Street",
"line2": "Northern Quarter",
"postalCode": "M4 1AA"
}
},
"verifiedAt": "2020-01-01T00:00:00Z"
}
}
}