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_KEYREQUEST
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.
* At least one of the four primary lookup fields is required.
Accepted emirate and authorising_body values
emirate
ajmanabu_dhabiabu_dahbidubaifujairahfujirahumm_al_quwainsharjahras_al_khaimahauthorising_body
RESPONSES
Exact response contract
The wrapper returns the original HTTP status and JSON body unchanged. A successful response contains the complete envelope and trade licence result below.
FieldTypeDescription
statusstringRequest result.client_idUUIDRequest identifier.secondsnumberProcessing time.uae_tl_verificationobjectCurrent verification result object.trade_licence_verification_apiobjectCompatibility result object name.↳ 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
Your credential and request are sent only to api.ai7uae.com. The credential is kept in memory for this page and is not stored.
API RESPONSEReady
{
"message": "Your JSON response will appear here."
}