Verify Id
Submit an identity document and a selfie to perform ID verification. Returns a verification status, confidence score, and extracted document fields for downstream workflows.
Overview
- Method: POST
- Path:
/brand/id-verification/verify - Tags: brand
Use Cases
- KYC/AML compliance checks before fulfilling regulated products.
- Age verification for products requiring minimum age.
- Fraud prevention by validating identity against submitted documents.
- Route to manual review when confidence is low (requires-review).
- Gate onboarding or checkout until ID is verified.
Parameters
No parameters required.
Request Body
- Content Type:
application/json - Required: Yes
Fields
| Field | Type | Required | Details |
|---|---|---|---|
| documentType | object | Yes | |
| documentImage | string | Yes | |
| selfieImage | string | Yes |
Responses
200
Successful response
Content Type: application/json
{
"verificationId": "string",
"status": {},
"confidence": 123,
"extractedData": "string",
"lastName": "string",
"dateOfBirth": "string",
"documentNumber": "string",
"expirationDate": "string"
}400
Bad Request
Content Type: application/json
{}401
Unauthorized
404
Not Found
500
Internal Server Error
Example Usage
curl -X POST \
https://api.pillexa.com/brand/id-verification/verify \
-H "Content-Type: application/json" \
-d '{"example": "data"}'