UAE TRN Verification

Endpoint Overview

POST /api/v1/uae-trn/verification

Description

The UAE TRN Verification API allows you to validate Tax Registration Numbers (TRN) issued by the Federal Tax Authority (FTA) in the United Arab Emirates. This endpoint verifies the authenticity of a TRN and returns associated entity information, helping businesses ensure compliance with UAE tax regulations and verify the legitimacy of their business partners.

Key Benefits

Instant verification of UAE Tax Registration Numbers

Retrieval of legal entity names associated with the TRN

Confirmation of TRN validity status

Streamlined KYC and compliance processes

Use Cases

Financial Services

E-commerce

Professional Services

Verify business client TRNs during onboarding processes

Validate supplier TRNs before processing invoice payments

Ensure tax compliance during business transactions

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 format
Content-Type	Yes	Application/json

Request Body

Parameter	Type	Required	Description
trn_number	String	Yes	The UAE Tax Registration Number to be verified

Example Request

{
    "trn_number": "100247583003"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the verification result data
data.client_id	String	Unique identifier for the client making the request
data.trn_number	String	The TRN number that was verified
data.legal_name	String	The legal name of the entity associated with the TRN
data.legal_name_list	Array	List of legal names associated with the TRN
data.trn_status	Boolean	Indicates whether the TRN is valid (true) or invalid (false)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates whether the API request was successful
message	String	Human-readable description of the response status
message_code	String	Machine-readable code representing the response status

Example Successful Response

{
    "data": {
        "client_id": "uae_trn_cZwtvbvgsarbGejxnmAR",
        "trn_number": "1002600000",
        "legal_name": "LLC",
        "legal_name_list": [
            "LLC"
        ],
        "trn_status": true
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid TRN

Authentication Error

Bad Request

{
    "data": {
        "client_id": "uae_trn_cZwtvbvgsarbGejxnmAR",
        "trn_number": "1002600001",
        "legal_name": null,
        "legal_name_list": [],
        "trn_status": false
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

The TRN number provided is invalid or does not exist in the FTA database.

Integration Best Practices

Security Recommendations

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

Implement token refresh mechanisms to handle token expiration

Use HTTPS for all API communications to ensure data encryption

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement real-time validation during user input to provide immediate feedback

Display clear error messages when TRN validation fails

Cache validation results (where appropriate) to improve performance

Provide clear instructions on TRN format requirements to users

Code Samples

cURL

Python

Node.js

Related APIs

UAE Business License Verification - Verify business licenses issued in the UAE

UAE Emirates ID Verification - Verify Emirates ID cards for UAE residents

UAE Passport Verification - Verify UAE passport information

Compliance and Legal Considerations

When using this API, ensure you have proper consent to verify TRN information and that your use complies with UAE data protection regulations. The verification of TRN numbers should be used for legitimate business purposes such as KYC, AML compliance, or business partner verification. Unauthorized use of this API for data harvesting or other non-compliant purposes is prohibited.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/uae-trn/verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "trn_number": "100247583003" }'

{ "data": { "client_id": "uae_trn_cZwtvbvgsarbGejxnmAR", "trn_number": "1002600000", "legal_name": "LLC", "legal_name_list": [ "LLC" ], "trn_status": true }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

UAE TRN

UAE TRN Verification#

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

UAE TRN Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples