PrivyPrivy
Sign in
  • Documentation
Back to Documentation
B2B Digital Certificate Issuance Support
OverviewChangelog
Insights API
Face Compare API
    v1
      OverviewQuickstartEnvironmentsAuthenticationRequest FieldsComparison ResultsErrors
KTP OCR API
ID Card Forgery
API Explorer
powered by Zudoku
Sign in
v1

Request Fields

Send the request as application/json.

FieldTypeRequiredValidation
transaction_idstringYes1–255 characters; letters, digits, hyphens, and underscores only.
face1stringYesRaw Base64-encoded JPEG, JPG, or PNG image. The decoded image must remain within the upload limit configured for your integration.
face2stringYesRaw Base64-encoded JPEG, JPG, or PNG image. The decoded image must remain within the upload limit configured for your integration.
Code
{ "transaction_id": "face-compare-001", "face1": "/9j/4AAQSkZJRgABAQAAAQABAAD...", "face2": "/9j/4AAQSkZJRgABAQAAAQABAAD..." }

Send Base64 values without a data:image/...;base64, prefix. Face Compare API v1 validates each image's Base64 data, decoded file size, and detected image type. It does not apply a documented pixel-dimension requirement.

Last modified on October 23, 2026
AuthenticationComparison Results
JSON