Brand
Id-verification
Verify

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

FieldTypeRequiredDetails
documentTypeobjectYes
documentImagestringYes
selfieImagestringYes

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"}'