National Identity

Text recognition on Indonesian Identity Card (KTP).

This endpoint only supports Indonesian identity cards (KTP)

Endpoints

Method	URL
POST	$vision/v1/ocr/id/ktp

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer YOUR_API_KEY

Request

The OCR inference time may vary. It depends on many factors, one of them is the image size. We recommend you to resize the image before sending it to Kredibel system.

Description

Field	Type	Description
image (Required)	<base64:image>	Image binary encoded in base64 without <data:image/png;>. - Supports: JPG, JPEG, PNG - Max Size: 2MB - Recommended size: 1024x768
cardDetect	Boolean (Default: true)	Use card detection model
passCardDetect	Boolean (Default: true)	If false, when identity card is not detected on the image it will return an error message
flipImage	Boolean (Default: false)	If true, the system will flip your image
checkFlipImage	Boolean (Default: false)	If true, the system will check whether your image is flipped or not
validateResult	Boolean (Default: false)	If true, you will get format validation information about result.

Example (Recommendation)

You just need to declare image field in order to use this service.

{
  "image": "/9j/..."
}

Example (Verbose)

{
  "image": "string",
  "cardDetect": true,
  "passCardDetect": true,
  "flipImage": true,
  "checkFlipImage": true,
  "validateResult": true
}

Response

Description

result

Field	Type	Description
identityId	String	Identity id (NIK)
fullName	String	Full name
birthPlace	String	Place of birth
birthDate	Date (dd-mm-yyyy)	Date of birth
gender	String	Gender
address	String	Address
province	String	Province
city	String	City
district	String	District
village	String	Village
rtrw	String	RT/RW
religion	String	Religion
maritalStatus	String	Marital status
occupation	String	Occupation
nationality	String	Nationality

information

Field	Type	Description
tilt	Float	Tilt degree (0-360) on identity card. If it is upside-down, then the value is 180.
cardDetected	Boolean	Return true if out system detected identity card on the image.

Example

{
  "message": "string",
  "data": {
    "id": "string",
    "result": {
      "identityId": "string",
      "fullName": "string",
      "birthPlace": "string",
      "birthDate": "string",
      "gender": "string",
      "address": "string",
      "province": "string",
      "city": "string",
      "district": "string",
      "village": "string",
      "rtrw": "string",
      "religion": "string",
      "maritalStatus": "string",
      "occupation": "string",
      "nationality": "string"
    },
    "information": {
        "tilt": float,
        "cardDetected": boolean
    }
  }
}

Errors

Please read this page <Responses & Errors> to know more about response.

Error 4XX

Error Type

Error Type	Description	Is charged?
invalid_base64_encoding	Invalid base64 encoding.	false
card_not_found	There is no identity card found in the image. This error only raised if you set passCardDetect = False.	true
text_not_found	There is no text found in the image.	true
invalid_document_type	The document sent does not appear to be the right identity type.	true
parsing_failed	System fail to parse identity card.	true

Structure

In general, the error response structure is as below:

{
   "errors":{
      "errorId": <log_id:uuid>,
      "errorType": <error_type:str>
   },
   "message": <message:str>
}

Error 5XX

For every 5XX http code response, there will be no charge.