AI7 UAE Verification PlatformAn AI7Lab company · Dubai ↗
KYCProbe by AI7Lab API available

VERIFICATION API / UAE

UAE Trade Licence
All Emirates.

Verify a UAE trade licence by licence number, company name, or document through one consistent AI7 UAE endpoint.

POST/service/uae_tlv

INSTRUCTIONS TO USE

How to use this API

Start here, then use the detailed request and response reference below.

  1. 01Get your API key

    Use a workspace API key in the Bearer header.

  2. 02Submit a lookup

    Send a licence number, company name, or document to the POST endpoint.

  3. 03Inspect the result

    Read the returned licence fields and source details before relying on them.

AUTHENTICATION

One credential across every AI7 API

Send your personal AI7 API key as an HTTP Bearer token. Keep it server-side and never place it in browser code or a public repository.

Authorization: Bearer YOUR_AI7_API_KEY

REQUEST

Submit a licence lookup

Use application/json or multipart/form-data. Provide at least one primary lookup field.

license_numberstring · optional*

Trade licence number.

licence_numberstring · optional*

Alternate spelling of license number.

company_namestring · optional*

Company name in English or Arabic.

license_documentfile/base64 · optional*

Licence document as a file, base64, or data URI.

emirateenum · optional

Issuing emirate, such as dubai.

authorising_bodyenum · optional

Authority that issued the licence.

X-AI7-Peppol-Checkheader · optional

Set to true to search the local UAE Peppol index using the name returned by licence verification. The response gains a separate peppol object with the snapshot time.

* At least one of the four primary lookup fields is required.

Accepted emirate and authorising_body values

emirate

ajmanabu_dhabiabu_dahbidubaifujairahfujirahumm_al_quwainsharjahras_al_khaimah

authorising_body


          


          

            
RESPONSES

            
Exact response contract

            
By default, the wrapper returns the supplier's HTTP status and JSON body unchanged. When Peppol is selected and verification succeeds, it adds a separate peppol object from the local UAE snapshot. The lookup does not send the company name to Peppol.

            

              
FieldTypeDescription

              
statusstringRequest result.

              
client_idUUIDRequest identifier.

              
secondsnumberProcessing time.

              
uae_tl_verificationobjectCurrent verification result object.

              
trade_licence_verification_apiobjectCompatibility result object name.

              
peppolobject · optionalUAE Directory name search, matching participant IDs, business cards and document types, or an explicit unavailable/no-result status. This does not verify the licence holder's identity.

              
↳ uae_licence_numberstringUAE licence number.

              
↳ expiration_datestringLicence expiration date.

              
↳ registration_datestringLicence registration date.

              
↳ licence_registration_name_arabicstringArabic registration name.

              
↳ licence_registration_namestringRegistration name.

              
↳ licence_registration_addressstringRegistration address.

              
↳ governing_body_namestringIssuing authority.

              
↳ emirate_namestringIssuing emirate.

              
↳ emirate_name_arabicstringIssuing emirate in Arabic, when returned.

              
↳ lcn_renewal_datestringLicence renewal date.

              
↳ moec_statusstringMinistry status.

              
↳ legal_type_from_entitystringRegistered legal type.

              
↳ unified_licence_numberstringUnified licence number.

              
↳ activity_start_timestringActivity start time.

              
↳ licence_registration_address_arabicstringArabic registration address.

              
↳ license_statusstringCurrent licence status.

              
↳ trade_license_numbernumber/nullTrade licence number score or value, when returned directly.

              
↳ risk_scoresobjectVerification risk-score container.

              
↳ risk_scores.trade_license_numbernumber/nullTrade licence number risk score.

            

            
Status codes

            

              
200Verification completed

              
400Invalid request format or parameters

              
401Missing or invalid AI7 API key

              
422Document invalid or not recognised

              
500Service request failed

            

          


          

            
LIVE TESTER

            
Run a request

            
This tester submits to the KYCProbe API engine. Direct integrations use api.ai7uae.com. The credential stays in this page's memory and is not stored.

            

              
              
              

                Primary lookup Provide at least one
                

                  
                  
                  
                  
                

                
For JSON, the selected document is encoded as a data URI. For multipart, the original binary file is uploaded.

              

              

                Optional filters
                

                  
                  
                

                
              

              
              
            

            
API RESPONSEReady

            
{
  "message": "Your JSON response will appear here."
}