Skip to content

Philippines TinID OCR

licenseNumber + name recognition

Code example:

curl --location --request POST 'https://api.ekycpro.com/v1/ph_ocr_tinid/general' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-API-Key: AbcdEfgh' \
--data-urlencode 'img=BASE64_ENCODE_VALUE'

Response for recognition success

{
"status": "OK",
"message": {
"fullName": "Dela Cruz,Mia",
"licenseNumber": "123-456-789-000",
"birthday": "09/04/1994",
"issueDate": "10/02/2017",
"address": "28 Payapa St.Bagong Diwa Sto.Cristobal,Caloocan City "
}
}

Response for recognition fail

{
"status": "FAIL",
"message": "check input image and retry"
}

Response for invalid request parameters

{
"status": "INVALID_REQUEST",
"message": "check request params"
}

Response for invalid image format

{
"status": "IMAGE_INVALID_FORMAT",
"message": "image format not support"
}

Response for image size larger than 2M

{
"status": "IMAGE_INVALID_SIZE",
"message": "image larger than 2M"
}

Response for server error

{
"status": "INNER_ERROR",
"message": "Inner error, please retry later"
}

HTTP request

POST https://api.ekycpro.com/v1/ph_ocr_tinid/general

Request parameters

parameterdescription
imgstring, base64 encoded image. It is recommended that the image be less than 200KB, so it will be returned within 2 seconds, otherwise the return time will be longer.

Response format

fieldsdescription
statusstatus code
messagelicenseNumber: the license number
fullName: fullName
birthday: date of birth
issueDate: date of issue
address: address

Status code

statusdescription
OKcharge, success
FAILcharge, image recognition error, please check input image
INVALID_REQUESTfree, invalid request parameters
IMAGE_INVALID_FORMATfree, invalid image format, image format should be one of jpeg/jpg/png/bmp
IMAGE_INVALID_SIZEfree, invalid image size, should be less than 2M
INNER_ERRORfree, server error