Skip to main content
POST
Document Verification — UK Passport
Verify a customer’s UK passport by uploading a photo of the data page — no manual passport number entry required. OCR extraction plus a required face match against a selfie — no liveness check (no video, no blink/motion challenge).
Passport is single-sided — only document_front is needed.
selfie_image is required — the face extracted from the document is compared against it. This is a still-image comparison (not liveness).
UK document verification currently supports passports only — national ID, driver’s license, and other UK document types are not yet available.

Endpoint

Request

Headers

Body Parameters

Example

Response

200 OK

Face Match Notes — if the comparison service itself fails, attempted reflects whether a comparison was actually run and verified comes back null with a reason field explaining why — this is different from verified: false, which means the comparison ran and the faces didn’t match. A face-match problem never blocks the underlying document data — the rest of data is still returned.

400 Bad Request

401 Unauthorized

For a full list of error codes, see the Error Codes reference.

Authorizations

x-access-token
string
header
required

Your Adhere API secret key

Body

multipart/form-data
document_front
file
required

Photo of the passport data page. JPG or PNG, max 5MB.

selfie_image
file

A selfie to compare against the face extracted from the document. JPG or PNG, max 5MB. Required.

Response

Document details extracted successfully

status
string
Example:

"success"

data
object
message
string
Example:

"Document details retrieved successfully"