Identity Verification Statuses

This page sets out possible statuses, explanatory status codes, CDD Report availability, and risk codes for Identity Verification.

Note

In addition to checking the status in webhook notifications, you can check the status of a specific Identity Verification case at any time via a Get case status request.

Statuses

Possible notifications include:

Status	Guidance
`new`	Description: The workflow is successfully created. Action: • SDK integration: Wait for the next status. • API integration: Upload the identity data and identity files.
`pending`	Description: We are validating the data. Action: Wait for the next status. Status code: `1000`
`inconsistent_data`	Description: We found inconsistent data. Action: Create a new workflow. Status codes: `2000` – `3000` series
`invalid_data`	Description: We found invalid or missing data. Action: Create a new workflow. Status codes: `1001` – `1999`
`completed`	Description: We have processed the case. For our recommendation to accept or reject the client, see the risk code. Risk codes: • `200` – `500`: `100` series status codes • `500`: `4000` – `5000` series status codes Action: Download the CDD Report zipfile.

Status flow diagram

The pathways for statuses are as follows:

Risk codes

Possible risk codes include:

Risk code	Risk score
`200`	completed_low_risk
`300`	completed_medium_risk
`400`	completed_high_risk
`500`	completed_unacceptable_risk

Status codes

Statuses can be accompanied by one or multiple of the following status codes:

100: AML screening

This series can accompany completed status and includes:

Status code	Description
`100`	False positive sanctions hit
`102`	False positive sensitivity list hit
`110`	False positive PEP hit
`120`	Confirmed PEP hit

1000: Identity data

This series can accompany invalid_data status (except for 1000 which accompanies pending status) and includes:

Status code	Guidance
`1000`	Description: Data successfully validated
`1004`	Description: `person.type` invalid Action: Update the identity data, setting `person.type` to `naturalPerson` or `legalPerson`.
`1005`	Description: `person.fullName` invalid or missing Action: Update the identity data, setting the `person.fullName` format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
`1006`	Description: `person.firstName` invalid or missing Action: Update the identity data, setting the `person.firstName` format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
`1007`	Description: `person.lastName` invalid or missing Action: Update the identity data, setting the `person.lastName` format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
`1008`	Description: `person.gender` invalid or missing Action: Update the identity data, setting `person.gender` to `Female`, `Male`, `Other`, or `Unknown` (case sensitive).
`1009`	Description: `person.nationality` invalid or missing Action: Update the identity data, setting `person.nationality` to a valid ISO_3166-1 alpha-3 country code.
`1010`	Description: `person.birthDate` invalid or missing Action: Update the identity data, setting `person.birthDate` to a valid date in YYYY-MM-DD format.
`1011`	Description: `address.country` invalid or missing Action: Update the identity data, setting `address.country` to a valid ISO_3166-1 alpha-3 country code.
`1012`	Description: `emailAndPhone.email` invalid or missing Action: Update the identity data, setting `emailAndPhone.email` to a valid email address including an @ character.
`1013`	Description: `emailAndPhone.mobile` invalid or missing Action: Update the identity data, setting `emailAndPhone.mobile` to a valid mobile phone number including the country code and beginning with `00` or `+` without spaces. Example: `0031201234567` or `+31201234567`
`1014`	Description: `address.streetNumber` invalid or missing Action: Update the identity data, setting `address.streetNumber` to an integer greater than or equal to zero.
`1015`	Description: `address.street` invalid or missing Action: Update the identity data, setting `address.street` with only alphabetical characters, spaces, hyphens, and apostrophes.
`1016`	Description: `address.postalCode` invalid or missing Action: Update the identity data, setting `address.postalCode`.
`1017`	Description: `address.city` invalid or missing Action: Update the identity data, setting the `address.city` format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
`1018`	Description: `kycDocument.documentType` missing Action: Update the identity file, setting `kycDocument.documentType`.
`1021`	Description: `person.nationality` not supported for this document type Action: Ask the client to use a supported ID document for their nationality.
`1022`	Description: ID document missing Action: Upload an ID document.
	Description: `tax.countrySubjectToTaxation` invalid Action: Update the identity data, changing the `tax.countrySubjectToTaxation` format to a valid ISO_3166-1 alpha-3 country code.
`1023`	Description: Selfie photo missing Action: Upload a selfie photo.
`1024`	Description: ID document photo(s) missing or inconsistent Action: Upload new document photos.
`1025`	Description: All `riskRequirement` parameters are required Action: Update the identity data, setting all `riskRequirement` parameters.
`1031`	Description: Identity data too old Action: Upload new identity data.
`1032`	Description: Client not a natural person Action: Update the identity data, setting `person.type` to `Natural Person`.
`1033`	Description: `person.fullName` format invalid Action: Update the identity data, making sure `person.fullName` consists of at least 2 words.
`1034`	Description: Underage client Action: None. You can't retry.
`1035`	Description: Ineligible client due to unsupported country of residence Action: None. You can't retry.
`1036`	Description: ID document number already used Action: Upload a new ID document.
`1037`	Description: `kycDocument.documentNumber` missing Action: Update the identity file, setting `kycDocument.documentNumber`.
`1100`	Description: Secondary document missing Action: Upload a secondary document.
`1201`	Description: Client not successfully verified Action: Create a new workflow for Identity Verification.

2000: Home address

This series can accompany inconsistent_data status and includes:

Status code	Guidance
`2001`	Description: Invalid address Action: Provide a valid address.
`2002`	Description: PO box address Action: Provide a valid non-PO box address.
`2003`	Description: Non-residential address Action: Provide a valid residential address.
`2004`	Description: Address doesn't match the PoAdocument Action: Provide a valid address request, or ask the client for a new official PoA document.

3000: Sendbacks

This series can accompany inconsistent_data status and includes:

Status code	Guidance
`3001`	Description: `person.nationality` doesn't match client input Action: Update the client's nationality.
`3002`	Description: `person.placeOfBirth` doesn't match client input Action: Update the client's place of birth.
`3005`	Description: `person.gender` doesn't match client input Action: Update the client's gender.
`3100`	Description: Selfie photo too bright Action: Upload a new selfie.
`3101`	Description: Selfie photo too dark Action: Upload a new selfie.
`3102`	Description: Selfie photo too blurry Action: Upload a new selfie.
`3103`	Description: Selfie photo poor quality Action: Upload a new selfie.
`3104`	Description: Selfie photo inadequate Action: Upload a new selfie.
`3105`	Description: Selfie doesn’t match ID document portrait Action: Create a new workflow for Identity Verification.
`3106`	Description: Inadequate input Action: Create a new workflow for Identity Verification.
`3107`	Description: Face not fully visible or within frame Action: Upload a new selfie.
`3108`	Description: Selfie photo GDPR breach Action: Upload a new selfie.
`3200`	Description: ID document photo too bright Action: Upload a new ID document.
`3201`	Description: ID document photo too dark Action: Upload a new ID document.
`3202`	Description: ID document photo too blurry Action: Upload a new ID document.
`3203`	Description: ID document photo poor quality Action: Upload a new ID document.
`3204`	Description: Expired ID document Action: Upload a new ID document.
`3205`	Description: Invalid ID document Action: Upload a new ID document.
`3206`	Description: ID document photo of a photocopy or screen Action: Upload a new ID document.
`3207`	Description: ID document photo obscured Action: Upload a new ID document.
`3208`	Description: ID document in inadequate condition Action: Upload a new ID document.
`3209`	Description: Issuing country not supported Action: Upload a new ID document.
`3210`	Description: Nationality not supported Action: Upload a new ID document.
`3211`	Description: ID document out of frame Action: Upload a new ID document.
`3212`	Description: ID document in plastic cover Action: Upload a new ID document.
`3213`	Description: ID document photo GDPR breach Action: Upload a new ID document.
`3250`	Description: Security features not visible Action: Upload a new ID document.
`3300`	Description: Unclear if legal name provided by client matches ID document Action: Update the client's full name.
`3304`	Description: Photos of required ID document sides missing Action: Provide the required number of photos for the document type.
`3305`	Description: ID document number doesn't match client input Action: Update the document number.
`3306`	Description: ID document issue date doesn't match client input Action: Update the issue date.
`3307`	Description: ID document expiry date doesn't match client input Action: Update the expiry date.
`3308`	Description: TIN not visible Action: Create a new workflow for Identity Verification.
`3311`	Description: QEC details don't match ID document Action: Create a new workflow that includes Qualified Electronic Signature.
`3400`	Description: Secondary document photo too bright Action: Upload a new secondary document.
`3401`	Description: Secondary document photo too dark Action: Upload a new secondary document.
`3402`	Description: Secondary document photo too blurry Action: Upload a new secondary document.
`3403`	Description: Secondary document photo poor quality Action: Upload a new secondary document.
`3404`	Description: Expired secondary document Action: Upload a new secondary document.
`3405`	Description: Invalid secondary document Action: Upload a new secondary document.
`3406`	Description: Secondary document photo of a photocopy or screen Action: Upload a new secondary document.
`3407`	Description: Secondary document photo obscured Action: Upload a new secondary document.
`3408`	Description: Secondary document in inadequate condition Action: Upload a new secondary document.
`3409`	Description: Secondary Document out of frame Action: Upload a new secondary document.
`3410`	Description: PoA document photo too bright Action: Upload a new PoA document photo.
`3411`	Description: PoA document photo too dark Action: Upload a new PoA document photo.
`3412`	Description: PoA document photo too blurry Action: Upload a new PoA document photo.
`3413`	Description: PoA document photo poor quality Action: Upload a new PoA document photo.
`3414`	Description: Expired PoA document Action: Upload a different PoA document.
`3415`	Description: Invalid PoA document Action: Upload a different PoA document.
`3416`	Description: PoA document photo of a photocopy or screen Action: Upload an authentic PoA document.
`3417`	Description: PoA document photo obscured Action: Upload a new PoA document photo.
`3418`	Description: PoA document in inadequate condition Action: Upload a different PoA document.
`3419`	Description: PoA document out of frame Action: Upload a new PoA document photo.
`3420`	Description: Name doesn't match the PoA document Action: Upload a new PoA document photo.
`3500`	Description: Geolocation not provided Action: Upload a new selfie with the geolocation.
`3505`	Description: Not the same person Action: Upload a new ID document and selfie.
`3510`	Description: Geolocation not supported Action: Upload a new selfie with the geolocation.
`3520`	Description: Photo metadata inconsistent Action: Upload a new document and selfie.
`3521`	Description: Video metadata inconsistent Action: Upload a new document and selfie.
`3540`	Description: Device metadata inconsistent Action: Upload a new document and selfie.
`3541`	Description: Device model inconsistent Action: Upload a new document and selfie.
`3542`	Description: Device language inconsistent Action: Upload a new document and selfie.
`3543`	Description: Device geolocation inconsistent Action: Upload a new document and selfie.
`3560`	Description: Invalid IP address Action: Provide a valid IP address.
`3600`	Description: Selfie video too bright Action: Upload a new selfie video.
`3601`	Description: Selfie video too dark Action: Upload a new selfie video.
`3602`	Description: Selfie video too blurry Action: Upload a new selfie video.
`3603`	Description: Selfie video poor quality Action: Upload a new selfie video.
`3604`	Description: Selfie video GDPR breach Action: Upload a new selfie video.
`3610`	Description: Selfie video inadequate Action: Upload a new selfie video.
`3620`	Description: Liveness features not visible Action: Upload a new selfie video.
`3700`	Description: Insufficient data Action: Create a new workflow for Identity Verification.

4000: Rejections

Fatal

The client cannot retry.

This series can accompany completed status and includes:

Status code	Description
`4110`	Confirmed sanctions hit
`4112`	Confirmed sensitivity list hit
`4120`	Underage client
`4130`	Unacceptable risk score
`4135`	Unacceptable combination of data points
`4140`	Country of residence not supported
`4145`	Geolocation prohibited
`4150`	Issuing country prohibited
`4155`	Nationality prohibited
`4160`	Hits above agreed threshold
`4170`	High-risk IP address
`4171`	High-risk country phone code
`4172`	High-risk country of residence
`4173`	High-risk geolocation
`4190`	Rejected (other)
`4192`	Selfie video rejected
`4200`	Unacceptable third-party involvement in selfie photo
`4202`	Unacceptable third-party involvement in selfie video
`4211`	Unacceptable third-party involvement in ID document photo
`4310`	Birth date doesn't match previous ID document
`4311`	Place of birth doesn't match previous ID document
`4400`	Name on ID document doesn't match client input

5000: Fraud

Fatal

The client cannot retry.

This series can accompany completed status and includes:

Status code	Description
`5100`	Tampered-with ID document
`5150`	Counterfeit ID document
`5200`	Tampered-with selfie photo
`5201`	Selfie photo is of another photo
`5202`	Impersonation
`5210`	Biometrics match known fraudster
`5300`	Tampered-with PoA document
`5400`	Fraudulent address
`5600`	Selfie video is of a video or a photo
`5601`	Client in selfie video doesn’t match ID document
`5602`	Client in selfie video wearing a mask
`5610`	Fraudulent selfie video
`5900`	Fraud (other)

6000: Qualified Electronic Signature errors

This series can accompany completed status and includes:

Status code	Guidance
`6001`	Description: Fatal error while creating the QEC Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature.
`6002`	Description: Error while creating the QEC Action: • SDK integration: Handled by the SDK. • API integration: Retry the Document approval step.
`6003`	Description: Communication error while creating the QEC Action: • SDK integration: Handled by the SDK. • API integration: Retry the Signature confirmation step.
`6004`	Description: Fatal error while signing documents Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature.
`6005`	Description: Error while signing documents Action: • SDK integration: Handled by the SDK. • API integration: Retry the Signature confirmation step.
`6006`	Description: Communication error while signing documents Action: • SDK integration: Handled by the SDK. • API integration: Retry the Signature confirmation step.
`6007`	Pending verification flow only Description: Fatal error while signing documents with provisional signature Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature.
`6008`	Description: Signature flow timed out Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature.