Selfie Photo ID Verification

Match a live selfie against a government-issued photo ID.

Request

POST/api/v1/kyc/photoid/verify

{{baseUrl}}/api/v1/kyc/photoid/verify

Header

Header	Type	Description
Authorization	string	`Bearer YOUR_ACCESS_TOKEN` from the OAuth client-credentials flow
Content-Type	string	application/json

Body Parameters

Parameter	Type	Description	Required
selfie_image	string	Base64 image of the user selfie	required
photoid_image	string	Base64 image of the ID photo	required

Request payload

Sample dataRequest payload

{
  "selfie_image": "https://cdn.example.com/sample.jpg",
  "photoid_image": "https://cdn.example.com/sample.jpg"
}

Expected response

200 OKSample dataExpected response

{
  "entity": {
    "status": "success",
    "match": true,
    "confidence_value": 98.7
  }
}

Response Fields

Field	Type	Description
entity	object	Contains the response data
entity.status	string	Status of the verification call
entity.match	boolean	Whether the verification matched
entity.confidence_value	number	Confidence score between 0 and 100

Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.