Skip to main content
POST
/
verifications
/
{verificationId}
/
validations
/
{processType}
Validate Verification Process
curl --request POST \
  --url https://api.urtentic.com/api/v1/verifications/{verificationId}/validations/{processType} \
  --header 'Content-Type: multipart/form-data' \
  --form 'documents=(binary file data)' \
  --form 'inputs[0]={
  "fieldName": "DOCUMENT_TYPE",
  "value": "PASSPORT"
}' \
  --form 'inputs[1]={
  "fieldName": "FRONT_IMAGE",
  "fileName": "passport_front.jpg",
  "value": "passport_front.jpg"
}' \
  --form documents.items='@example-file'
[]

Path Parameters

​
verificationId
string<uuid>
required

Unique identifier of the verification. This is the verificationId returned when starting a verification.

​
processType
enum<string>
required

Type of verification process to validate.

  • LIVENESS: Validates selfie video for liveness detection
  • DOCUMENT_VERIFICATION: Validates document images and data
  • LOCATION_INTELLIGENCE: Validates location and environment data
  • EMAIL_CHECK: Validates email verification inputs
Available options:
LIVENESS,
DOCUMENT_VERIFICATION,
LOCATION_INTELLIGENCE,
EMAIL_CHECK

Body

multipart/form-data
​
documents
file[]

Document files to validate. These should match the file types expected for the specified process type.

​
inputs
object[]

Field values to validate. These should include all required fields for the specified process type.

Response

Empty array when no validation errors are found

​
fieldName
string

Name of the field with validation error

Example:

"SELFIE_VIDEO"

​
message
string

Error message describing the validation failure

Example:

"Poor lighting detected in selfie video"

​
errorCode
string

Error code for programmatic handling. Common error codes:

General Errors

  • MISSING_FIELD: Required field is missing
  • INVALID_FORMAT: Field has incorrect format

Document Errors

  • DOCUMENT_EXPIRED: Document is expired
  • DOCUMENT_QUALITY: Image quality is insufficient
  • DOCUMENT_MISMATCH: Document type doesn't match selected type
  • DOCUMENT_TAMPERED: Signs of document tampering detected

Liveness Errors

  • POOR_LIGHTING: Inadequate lighting for liveness verification
  • MULTIPLE_FACES: Multiple faces detected in selfie
  • FACE_MISMATCH: Face doesn't match document photo
  • REPLAY_ATTACK: Potential replay attack detected

Location Errors

  • VPN_DETECTED: VPN or proxy detected
  • LOCATION_RESTRICTED: User in restricted location
  • LOCATION_MISMATCH: Location doesn't match expected location

Email Errors

  • INVALID_EMAIL: Email address format is invalid
  • EMAIL_RISK_HIGH: Email associated with high risk score
  • OTP_INVALID: One-time password is incorrect
Example:

"POOR_LIGHTING"