Start Verification Session

Exchange an invitation token for a short-lived session access token so the applicant can begin the biometric capture flow. This endpoint is called from the public verification page (no Bearer token).

Request

POST/api/v1/biometric/verify/{token}/start

{{baseUrl}}/api/v1/biometric/verify/{token}/start

Header

Header	Type	Description
Content-Type	string	application/json
Accept	string	application/json

Response

200 OKSample dataExample response

{
  "success": true,
  "response_code": 200,
  "message": "Access token generated",
  "data": {
    "access_token": "session_access_token..."
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
response_code	number	Application response code (typically mirrors HTTP)
message	string	Human-readable status message
data	object	Payload for the verified resource
request_id	string	UUID for support and audit trails

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.