TRN OCR

Endpoint Overview

POST /api/v1/ocr/uae-trn

Description

This API endpoint extracts the Tax Registration Number (TRN) from UAE tax registration documents using Optical Character Recognition (OCR) technology. It automatically processes images of TRN documents and returns the extracted TRN number along with a unique client identifier for tracking and reference purposes.

Key Benefits

Automates the extraction of TRN numbers from document images, eliminating manual data entry

Reduces processing time from minutes to seconds for tax document verification

Minimizes human error in TRN data capture and validation

Seamlessly integrates with existing KYC and onboarding workflows

Use Cases

Financial Services

Accounting & Tax

Business Registration

Streamline customer onboarding by automatically extracting TRN information

Validate tax registration details during business account setup

Automate tax verification for loan and credit applications

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token authentication using JWT token
Content-Type	Yes	Must be set to `multipart/form-data`

Request Body

Parameter	Type	Required	Description
file	Image/Pdf	Yes	Image file of the UAE TRN document to be processed. Supported formats include JPG, JPEG, and PNG.
use_pdf	Boolean	No	Only when input type is pdf

Example Request

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the extracted information
data.client_id	String	Unique identifier for this OCR request (format: ocr_uae_trn_[unique_string])
data.trn_number	String	The extracted Tax Registration Number from the document
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": {
        "client_id": "ocr_uae_trn_iEBcSPREgljzzjllxIST",
        "trn_number": "1005200000"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Image

Authentication Error

OCR Failure

{
    "status_code": 400,
    "success": false,
    "message": "Invalid image file provided",
    "message_code": "invalid_image"
}

The provided file is not a valid image or is in an unsupported format.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Implement token rotation and expiration policies for production environments

User Experience Guidelines

Provide clear instructions to users about acceptable image quality and formats

Implement a preview feature to help users capture clear images of TRN documents

Display a loading indicator during OCR processing to indicate activity

Implement proper validation of extracted TRN numbers (format and checksum if applicable)

Code Samples

cURL

Python

Node.js

Related APIs

UAE ID Card OCR: Extract personal information from UAE national ID cards

UAE Visa OCR: Extract details from UAE visa documents

UAE Trade License OCR: Extract business registration information from UAE trade licenses

Compliance and Legal Considerations

When processing TRN documents, ensure compliance with UAE data protection regulations. The extracted data should be handled securely and used only for legitimate business purposes. Retention of TRN document images should follow local regulatory requirements and your organization's data retention policies.

{ "data": { "client_id": "ocr_uae_trn_iEBcSPREgljzzjllxIST", "trn_number": "1005200000" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

TRN OCR

TRN OCR#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

TRN OCR

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples