UAE TRN Verification

Overview & Purpose

Overview

The Tax Registration Number (TRN) is a unique 15-digit identifier issued by the Federal Tax Authority in the UAE for businesses enrolled in the Value-added Tax (VAT) system. The TRN serves as a distinguishable reference for companies recognized by the federal tax authorities. Having a TRN certificate grants companies and merchants the authority to levy VAT charges on their customers. The government utilizes the TRN to track and monitor all purchases conducted by companies. This API verifies UAE Tax Registration Numbers (TRN). It allows users to submit a TRN to check its validity, retrieve associated legal names, and determine the status of the TRN. The TRN plays a crucial role in maintaining transparency and accountability within the VAT system, ensuring accurate record-keeping, and facilitating effective tax compliance for businesses in the UAE.

Use cases

Business Verification:

Allows businesses to verify the TRN of their partners or suppliers to ensure they are registered and legally compliant for tax purposes.

Financial Transactions:

Crucial for financial departments to validate TRN before processing payments and invoices, ensuring compliance with UAE tax regulations.

E-Commerce Platforms:

E-commerce platforms can use this API to verify the TRN of sellers on their platform, ensuring all transactions are tax-compliant.

Audit and Compliance:

Useful for audit firms and compliance departments to verify the accuracy of the TRN number provided by the business they are dealing with

Registration Processes:

Assists in various registration processes where validating a company's tax registration status is necessary before proceeding with contractual agreements or official engagements.

API Details

Sample cURL

Pre-Production

Production

curl --location --request POST 'https://api-preproduction.signzy.app/api/v3/uae/trn-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization: <....Auth Token....>' \
--data-raw '{
	"trnNumber": "100505021400003"
}'

curl --location --request POST 'https://api.signzy.ae/api/v3/uae/trn-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization: <kongAuthKey>' \
--data-raw '{
	"trnNumber": ""
}'

API Input

The API accepts the following JSON input:

{
  "trnNumber": "100505021400003"
}

Field	Type	Description
trnNumber	string	The Tax Registration Number (TRN) to be verified.

API Output

Success Response & Mapping

{
    "data": {
        "clientId": "",
        "trnNumber": "100505021400003",
        "legalName": "ENTERPRISE WORKS COMMERCIAL BROKERS L.L.C",
        "legalNameList": [
            "ENTERPRISE WORKS COMMERCIAL BROKERS L.L.C"
        ],
        "trnStatus": true
    },
    "statusCode": 200,
    "success": true,
    "message": "Success",
    "messageCode": "success"
}

Field	Type	Description
data	object	Contains the TRN verification information.
data.clientId	string	Identifier for the client.
data.trnNumber	string	The Tax Registration Number.
data.legalName	string	The legal name of the entity associated with the TRN.
data.legalNameList	object	List of legal names associated with the TRN
data.trnStatus	boolean	Indicates whether the TRN is valid (true) or not (false).
statusCode	number	HTTP status code of the API response.
success	boolean	Indicates the success status of the API request.
message	string	A message describing the result of the API request.
messageCode	string	A code representing the result of the API request.

Error Code Response and Mapping

{
  "error": {
    "reason": "Error From Upstream",
    "status": 409,
    "message": "Upstream Down",
    "type": "Conflict",
    "statusCode": 409
  }
}

Field	Type	Description
reason	string	Reason for the error.
status	number	HTTP status code.
message	string	Error message indicating an error.
type	string	Error type.
statusCode	number	Status code representing the error scenario.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!