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

Errors

Code
{ "code": 422, "status": "failed", "message": "invalid ktp" }
HTTP statusMeaningCommon messages
400A dependency, OCR provider, billing, or usage request failed.access timeout or a provider error message
401Credentials, merchant key, or channel configuration could not be authenticated.invalid authorization, invalid merchant key, authentication failed
403The integration cannot use this service or has insufficient balance.forbidden, insufficient balance
404A configured result or required field mapping was not found.result config not found, field not found
422The JSON body, transaction ID, KTP image, or an enabled image-quality check is invalid.See validation messages below.
503The service is under maintenance.service is currently under maintenance

Validation can return:

  • invalid payload
  • empty trId
  • trId length must be between 1 and 36
  • invalid trId
  • empty ktp
  • invalid ktp
  • ktp above image size requirement
  • Invalid KTP Image when an enabled KTP detection or blur check fails
Last modified on October 23, 2026
OCR ResultsID Card Forgery v1
JSON