Face and ID Card Verification for KYC

Compares a selfie with the photograph on an ID card and says whether they show the same person, with a confidence for each check and for the combined verdict.

POST/v3/store/ekyc/face-and-id-card-verification

+2 endpoints

Try it

• Price1 ICper request
• Served65.4Kcalls

• v1.0
• Active

Input

OutputPOST /v3/store/ekyc/face-and-id-card-verification

idcard

confidence: 66.872 isSamePerson: true

selfie

confidence: 86.04 isSamePerson: true

time_process

0.824

total

confidence: 76.456 isSamePerson: true

Every field, under ResponseOther endpoints: /back, /front see Request

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification \
  -H "apikey: YOUR_API_KEY" \
  -F "file0=@id-card.jpg" \
  -F "file1=@selfie.jpg"

Response

200OK. The fields are explained under Response.

{
    "idcard": { "confidence": 66.872, "isSamePerson": "true" },
    "selfie": { "confidence": 86.04, "isSamePerson": "true" },
    "time_process": 0.824,
    "total": { "confidence": 76.456, "isSamePerson": "true" }
}

Request

multipart/form-data, the card and the selfie in one request.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

file0filerequired

The ID card, photographed so the printed photo is legible. JPEG, PNG or GIF, at least 600 × 400 px, up to 10 MB.

file1filerequired

The selfie of the card's holder, the same limits.

Endpoint	Returns	Price
/v3/store/ekyc/face-and-id-card-verification	The verdict	1 IC per request
/v3/store/ekyc/face-and-id-card-verification/front	The verdict, from the front of a Thai national ID card	1 IC per page
/v3/store/ekyc/face-and-id-card-verification/back	The same, from the back	1 IC per page

The legacy paths /face-verify-id2, /thai-national-id-card/v3/front/kyc and /thai-national-id-card/v3/back/kyc answer at the same prices.

Response

idcardselfie

The two checks

idcard.confidencenumber

0 to 100

idcard.isSamePersonstring

totalobject

The combined verdict; its confidence is the mean of the two

total.confidencenumber

0 to 100

total.isSamePersonstring

time_processnumber

Seconds

Status codes

Code	Meaning
413	A file is over 10 MB
415, 442	Unsupported file format
420	file0 or file1 is missing
421	No face, or no card, found in an image
422	No face found on the card or in the selfie
441	Too many images
461	No file attached

Details

Measured

Measure	Result
False rejection rate	under 3%
False acceptance rate	under 0.1%

Limits

• One face in the selfie.

Data handling

Images are processed in memory and not kept after the response. The service is GDPR and PDPA compliant.