Skip to main content
GET
{base_url}
/
otk-service
/
customer-details
/
:journeyToken
Customer Details
curl --request GET \
  --url https://api.example.com/{base_url}/otk-service/customer-details/:journeyToken \
  --header 'accept: <accept>' \
  --header 'x-transaction-key: <x-transaction-key>'
{
  "result": {
    "success": true,
    "message": "Customer details fetched successfully",
    "data": {
      "uaeKycId": "139",
      "uidNumber": -144,
      "uaeKycCertificate": "",      
      "touristInfo": {
        "touristId": "1234"
      },

      "personalInfo": {
        "genderAr": "ذكر",
        "genderEn": "Male",
        "mobileNo": "0000000000",
        "insideUAE": "No",
        "fullNameAr": "جون أحمد دو",
        "fullNameEn": "John Ahmed Doe",
        "dateOfBirth": "1990-01-15",
        "firstNameAr": "جون",
        "firstNameEn": "John",
        "personClass": "Resident",
        "familyNameAr": "دو",
        "familyNameEn": "Doe",
        "motherNameAr": "فاطمة",
        "motherNameEn": "Fatima",
        "occupationAr": "مهندس",
        "occupationEn": "Engineer",
        "secondNameAr": "أحمد",
        "secondNameEn": "Ahmed",
        "placeOfBirthAr": "مومباي",
        "placeOfBirthEn": "Mumbai",
        "maritalStatusAr": "أعزب",
        "maritalStatusEn": "SINGLE",
        "hijriDateOfBirth": "1410-06-18",
        "immigrationStatus": "ACTIVE",
        "currentNationality": "IND",
        "personClassification": "RESIDENCE"
      },

      "travelDetail": {
         "isInsideUAE": true,
        "travelDate": "2024-12-01",
        "travelTime": "14:30:23",
        "travelType": "Inside UAE",
        "travelDocumentNo": "A1234567",
        "travelDocumentIssueDate": "2020-03-10",
        "travelDocumentExpiryDate": "2030-03-09"
      },
      "residenceInfo": {
        "issueDate": "2023-05-01",
        "documentNo": "201/2023/1234567",
        "expiryDate": "2033-05-01",
        "sponsorNameAr": "شركة أ ب ج ذ.م.م",
        "sponsorNameEn": "ABC Company LLC",
        "emiratesIdNumber": "784200058404151",
        "residenceClassAr": "إقامة عمل",
        "residenceClassEn": "WORK RESIDENCE",
        "residenceDepartmentAr": "غير معروف",
        "residenceDepartmentEn": "UNKNOWN",
        "accompanyCount": "0"
      },

      "activePassport": {
        "issueDate": "2020-03-10",
        "documentNo": "A1234567",
        "expiryDate": "2030-03-09",
        "documentType": "ORDINARY PASSPORT",
        "documentNationality": "India",
        "documentIssueCountry": "India",
        "documentNationalityAbbr": "IND",
        "documentIssueCountryAbbr": "IND"
      },

      "sponsorDetails": {
        "nameAr": "شركة أ ب ج ذ.م.م",
        "nameEn": "ABC Company LLC",
        "departmentAr": "غير معروف",
        "departmentEn": "UNKNOWN",
        "sponsorTypeAr": "شركات",
        "sponsorTypeEn": "COMPANIES",
        "sponsorNationality": "United Arab Emirates",
        "sponsorNationalityAbbr": "ARE",
        "sponsorIdn": "123456789",
        "tradeLicense": "TL-12345",
      },
      "immigrationFile": {
        "status": "ACTIVE",
        "issueDate": "2023-05-01",
        "expiryDate": "2025-04-30",
        "fileNumber": "101/2025/123/123456",
        "fileTypeAr": "تصريح دخول متعدد قصير المدة زيارة/سياحة",
        "fileTypeEn": "Multi S. Term Entry Permit Visit/Tourism",
        "issuePlace": "FEDERAL AUTHORITY FOR IDENTITY & CITIZENSHIP \\ ABU DHABI"
      },

  "personContactDetails": {
    "poBox": "12345",
    "areaAr": "البرشاء",
    "areaEn": "Al Barsha",
    "cityAr": "دبي",
    "cityEn": "Dubai",
    "mobileNo": "+971501234567",
    "emirateAr": "دبي",
    "emirateEn": "DUBAI",
    "streetAr": "شارع الشيخ زايد",
    "streetEn": "Sheikh Zayed Road",
    "homePhone": "+97141234567",
    "workPhone": "+97142345678"
  },

  "sponsorContactDetails": {
    "poBox": "54321",
    "emirateAr": "دبي",
    "emirateEn": "DUBAI",
    "cityAr": "دبي",
    "cityEn": "Dubai",
    "areaAr": "ديرة",
    "areaEn": "Deira",
    "streetAr": "شارع بني ياس",
    "streetEn": "Baniyas Road",
    "email": "info@abccompany.ae",
    "mobileNo": "+971501234567",
    "workPhone": "+97142345678",
    "homePhone": "+97141234567"
  },
      "documents": {
        "passportImage": "",
        "personFace": "",
        "digitalSignature": "",
        "digitalEID": ""
      }
    },
    "createdAt": 1776343071887,
    "meta": {
      "apiEndpoint": "/otk-service/customer-details",
      "serverTimestamp": 1776343497975,
      "journeyType": "ONBOARDING",
      "journeyToken": "13a7efd7-d32d-4392-acd8-2e149e58d12b"
    },
    "errors": [],
    "warnings": [
      {
        "code": "UAEKYC-WARN-ICP-002",
        "type": "ICP",
        "message": "Document & ICP record data mismatch for document expiry"
      }
    ]
  },
  "signature": ""
}
Customer data is available for 24 hours after journey creation. Call this API promptly after the journey completes and store the data you need.
Field Availability: Not all fields are populated for every customer. Available fields depend on the document type scanned and the modules enabled for your organization. Always handle empty or missing fields gracefully.

Authentication

x-transaction-key
string
required
Your API key. Get your key →
accept
string
required
Must be application/json

Path Parameters

journeyToken
string
required
UUID v4 of the journey from the Create Journey API (36 characters).

Code Examples

curl "{base_url}/otk-service/customer-details/{journeyToken}" \
  -H "accept: application/json" \
  -H "x-transaction-key: your-api-key"

Response Fields

Response Structure
{
  "result": {
    "success": true,
    "message": "...",
    "data": { ... },
    "createdAt": ...,
    "meta": { ... },
    "errors": [],
    "warnings": []
  },
  "signature": "..."
}

Envelope

FieldTypeDescription
result.successboolean | absenttrue for COMPLETED or ADJUDICATED journeys, false for REJECTED. Not present for other statuses (NOT STARTED, IN PROGRESS, EXPIRED, ABANDONED).
result.messagestringHuman-readable status message.
result.dataobjectCustomer data container (present on success).
result.createdAtnumberJourney creation timestamp (epoch milliseconds).
result.meta.apiEndpointstringThe API endpoint that was called.
result.meta.serverTimestampnumberServer timestamp (epoch milliseconds).
result.meta.journeyTypestringThe journey type: ONBOARDING, REKYC, or AUTHORISE.
result.meta.journeyTokenstringThe journey token that was queried.
result.errorsobject[]Filtered errors (type ICP only) objects. Empty array on success.
result.warningsobject[]Filtered warnings (type ICP only) object. Empty array when none. Each object has code, type, and message.
signaturestringCryptographic signature for response verification.

Top-Level Customer Data

FieldTypeDescription
result.data.uaeKycIdstringUnique UAE KYC identifier for this customer. Save this — you’ll need it for Re-KYC and AUTHORISE journeys.
result.data.uidNumberintegerUID person number.
result.data.uaeKycCertificatestring (Base64)Base64-encoded PDF of the digital KYC certificate issued upon successful verification.

Tourist Information (result.data.touristInfo)

null when the customer is not a tourist or GCC visitor.
FieldTypeDescriptionData Availability
result.data.touristInfo.touristIdstringUnique tourist identification number.Available for Tourists & GCC Visitors

Personal Information (result.data.personalInfo)

FieldTypeDescriptionData Availability
result.data.personalInfo.currentNationalitystringCurrent nationality (ISO 3166-1 alpha-3 code, 3 characters). Example: "IND", "ARE", "GBR".Available for all scenarios
result.data.personalInfo.fullNameAr / fullNameEnstringFull name in Arabic / English (up to 200 characters).Available for all scenarios
result.data.personalInfo.firstNameAr / firstNameEnstringFirst name in Arabic / English (up to 100 characters).Available for all scenarios
result.data.personalInfo.secondNameAr / secondNameEnstringMiddle/second name in Arabic / English (up to 100 characters).Available for all scenarios
result.data.personalInfo.familyNameAr / familyNameEnstringFamily (last) name in Arabic / English (up to 100 characters).Available for all scenarios
result.data.personalInfo.motherNameAr / motherNameEnstringMother’s name in Arabic / English (up to 200 characters).Available for all scenarios
result.data.personalInfo.dateOfBirthstringDate of birth (YYYY-MM-DD, 10 characters).Available for all scenarios
result.data.personalInfo.hijriDateOfBirthstringDate of birth in Hijri calendar (YYYY-MM-DD, 10 characters).Available for all scenarios
result.data.personalInfo.personClassenumResidency classification: UAE Citizen, GCC Citizen, Visitor, Resident.Available for all scenarios
result.data.personalInfo.personClassificationstringPerson classification code: LOCAL, GCC, RESIDENCE, VISITOR, GOLDEN.Available for all scenarios
result.data.personalInfo.genderEn / genderArenumMALE, FEMALE, UNKNOWN.Available for all scenarios
result.data.personalInfo.maritalStatusEn / maritalStatusArenumSINGLE, MARRIED, DIVORCED, WIDOWED, Bachelor, Dead.Available for all scenarios
result.data.personalInfo.placeOfBirthAr / placeOfBirthEnstringPlace of birth in Arabic / English (up to 100 characters).Available for all scenarios
result.data.personalInfo.mobileNostringRegistered mobile number (E.164 format, up to 15 characters). Example: "+971501234567".Available for all scenarios
result.data.personalInfo.titleEn / titleArstringName title/prefix in English / Arabic (up to 50 characters). Example: "Mr", "H.E.".Available for all scenarios
result.data.personalInfo.insideUAEenumWhether the person is currently inside UAE: Yes, No.Available for all scenarios
result.data.personalInfo.immigrationStatusenumACTIVE, INACTIVE, NA.Available for all scenarios
result.data.personalInfo.occupationAr / occupationEnstringOccupation in Arabic / English (up to 200 characters).Available for all scenarios

Passport (result.data.activePassport)

null when the customer does not have a passport on record (e.g., UAE citizens using only Emirates ID).
FieldTypeDescriptionData Availability
result.data.activePassport.documentTypestringPassport document type. See Passport Document Types below.Available for all scenarios
result.data.activePassport.documentNostringPassport number (up to 20 characters).Available for all scenarios
result.data.activePassport.documentNationalitystringNationality on the passport — full name (up to 100 characters).Available for all scenarios
result.data.activePassport.documentNationalityAbbrstringNationality abbreviation (ISO 3166-1 alpha-3, 3 characters).Available for all scenarios
result.data.activePassport.documentIssueCountrystringCountry that issued the passport — full name (up to 100 characters).Available for all scenarios
result.data.activePassport.documentIssueCountryAbbrstringIssuing country abbreviation (ISO 3166-1 alpha-3, 3 characters).Available for all scenarios
result.data.activePassport.issueDatestringPassport issue date (YYYY-MM-DD, 10 characters).Available for all scenarios
result.data.activePassport.expiryDatestringPassport expiry date (YYYY-MM-DD, 10 characters).Available for all scenarios
Document Type
ORDINARY PASSPORT
DIPLOMATIC PASSPORT
OFFICIAL PASSPORT
SERVICE PASSPORT
TEMPRORY PASSPORT
TRAVEL DOCUMENT
ORDINARY ONE DAY PASSPORT -MISSION PASSPORT
PRIVATE PASSPORT
Passport For Public Affairs
NAUTICAL PASSPORT
ASSIGNMENT PASSPORT
European Union passport
PERSONAL IDENTITY
SYRIAN TRAVEL DOCUMENT
EGYPTIAN TRAVEL DOCUMENT
LEBANSE TRAVEL DOCUMENT
This is not an exhaustive list. Additional document types may be returned depending on the government record.

Contact & Address (result.data.personContactDetails)

null when no contact information is available in government records.
FieldTypeDescriptionData Availability
result.data.personContactDetails.emirateEn / emirateArenumEmirate of residence: ABU DHABI, DUBAI, SHARJAH, AJMAN, UMM AL QUWAIN, RAS AL KHAIMAH, FUJAIRAH.Available for all scenarios
result.data.personContactDetails.cityAr / cityEnstringCity of residence (up to 100 characters).Available for all scenarios
result.data.personContactDetails.areaAr / areaEnstringArea/district (up to 100 characters).Available for all scenarios
result.data.personContactDetails.streetAr / streetEnstringStreet address (up to 200 characters).Available for all scenarios
result.data.personContactDetails.poBoxstringP.O. Box number (up to 10 characters).Available for all scenarios
result.data.personContactDetails.mobileNostringMobile phone number (E.164 format, up to 15 characters).Available for all scenarios
result.data.personContactDetails.homePhonestringHome landline number (E.164 format, up to 15 characters).Available for all scenarios
result.data.personContactDetails.workPhonestringWork phone number (E.164 format, up to 15 characters).Available for all scenarios

Travel Details (result.data.travelDetail)

null when no travel history is on record.
FieldTypeDescriptionData Availability
result.data.travelDetail.isInsideUAEbooleanWhether the person is currently inside the UAE: true, false.Available for all scenarios
result.data.travelDetail.travelTypeenumDirection of last travel movement: Inside UAE, Outside UAE.Available for all scenarios
result.data.travelDetail.travelDatestringDate of last travel movement (YYYY-MM-DD).Available for all scenarios
result.data.travelDetail.travelTimestringTime of last travel movement (HH:mm:ss, 24-hour).Available for all scenarios
result.data.travelDetail.travelDocumentNostringPassport or travel document number used at the border (up to 20 characters).Available for all scenarios
result.data.travelDetail.travelDocumentIssueDatestringIssue date of the travel document (YYYY-MM-DD).Available for all scenarios
result.data.travelDetail.travelDocumentExpiryDatestringExpiry date of the travel document (YYYY-MM-DD).Available for all scenarios

Residence & Emirates ID (result.data.residenceInfo)

null for visitors and short-term visa holders without an active residence permit.
FieldTypeDescriptionData Availability
result.data.residenceInfo.residenceClassEn / residenceClassArenumWORK RESIDENCE, SERVICE, RESIDENT RESIDENCE.Available for Active Residents
result.data.residenceInfo.residenceDepartmentEn / residenceDepartmentArstringGovernment department that issued the residence permit (up to 200 characters).Available for Active Residents
result.data.residenceInfo.accompanyCountstringNumber of dependents included on the visa (up to 5 characters).Available for Active Residents
result.data.residenceInfo.sponsorNameEn / sponsorNameArstringVisa sponsor name in English / Arabic (up to 200 characters).Available for Active Residents
result.data.residenceInfo.issueDatestringResidence visa issue date (YYYY-MM-DD).Not Available for Visitors
result.data.residenceInfo.expiryDatestringResidence visa expiry date (YYYY-MM-DD).Not Available for Visitors
result.data.residenceInfo.emiratesIdNumberstringEmirates ID number (15 digits starting with 784).Not Available for Visitors
result.data.residenceInfo.documentNostringResidence document/visa number.Not Available for Visitors
null for UAE/GCC citizens.
FieldTypeDescriptionData Availability
result.data.sponsorDetails.nameEn / nameArstringSponsor name in English / Arabic (up to 200 characters).Available for Active Residents and Visitors
result.data.sponsorDetails.departmentEn / departmentArstringGovernment department managing the sponsorship (up to 200 characters).Available for Active Residents and Visitors
result.data.sponsorDetails.sponsorNostringUnique sponsor reference number (up to 20 characters).Available for Active Residents and Visitors
result.data.sponsorDetails.sponsorTypeEn / sponsorTypeArenumSponsor category: AGRICULTURAL ORGANIZATION, COMPANIES, DIPLOMATIC GUARANTOR, ESTATE GUARANTOR, FARM GUARANTOR, FISHING BOATS, GCC GUARANTOR, GOVERNMENT-FEDERAL, GOVERNMENT -LOCAL, GUARDIAN OF THE HEIRS, LOCAL GUARANTOR, OTHERS, RESIDENCE GUARANTOR, SEMI - GOVERNMENT, SHEIKH GUARANTOR.Available for Active Residents and Visitors
result.data.sponsorDetails.sponsorIdnstringSponsor’s Emirates ID or trade license identification number (up to 20 characters).Available for Active Residents and Visitors
result.data.sponsorDetails.sponsorNationalitystringSponsor nationality — full name (up to 100 characters).Available for Active Residents and Visitors
result.data.sponsorDetails.sponsorNationalityAbbrstringSponsor nationality (ISO 3166-1 alpha-3, 3 characters).Available for Active Residents and Visitors
result.data.sponsorDetails.tradeLicensestringTrade license number for company sponsors (up to 20 characters).Available for Active Residents and Visitors
null when sponsorDetails is null.
FieldTypeDescriptionData Availability
result.data.sponsorContactDetails.emirateEn / emirateArenum/stringSponsor’s emirate in English / Arabic.Available for Active Residents and Visitors
result.data.sponsorContactDetails.cityEn / cityArstringSponsor’s city in English / Arabic (up to 100 characters).Available for Active Residents and Visitors
result.data.sponsorContactDetails.areaEn / areaArstringSponsor’s area/district in English / Arabic (up to 100 characters).Available for Active Residents and Visitors
result.data.sponsorContactDetails.streetEn / streetArstringSponsor’s street address in English / Arabic (up to 200 characters).Available for Active Residents and Visitors
result.data.sponsorContactDetails.poBoxstringSponsor’s P.O. Box number (up to 10 characters).Available for Active Residents and Visitors
result.data.sponsorContactDetails.emailstringSponsor’s email address (up to 100 characters).Available for Active Residents and Visitors
result.data.sponsorContactDetails.mobileNostringSponsor’s mobile number (E.164 format, up to 15 characters).Available for Active Residents and Visitors
result.data.sponsorContactDetails.homePhonestringSponsor’s home phone number (up to 15 characters).Available for Active Residents and Visitors
result.data.sponsorContactDetails.workPhonestringSponsor’s work phone number (up to 15 characters).Available for Active Residents and Visitors

Immigration File (result.data.immigrationFile)

Data Availability by Customer Type:
  • UAE Citizens & GCC Nationals: Only status: "NA" field is populated, as they do not require immigration files for UAE entry
  • Residents: Complete immigration file data including status, fileTypeEn/Ar, fileNumber, issuePlace, issueDate, and expiryDate
  • Visitors/Tourists: Full immigration file details with status: "INACTIVE" and relevant visa information
For Tourist Visa Holders: Ignore the status field for tourist visa holders - focus on issueDate and expiryDate for visa validity. The status field is only applicable for residents.
FieldTypeDescriptionData Availability
result.data.immigrationFile.statusenumImmigration file status: Active, Inactive, NA.Available for Active Residents and Visitors
result.data.immigrationFile.fileTypeEn / fileTypeArstringImmigration file type. See Immigration File Types below.Available for Active Residents and Visitors
result.data.immigrationFile.fileNumberstringImmigration file number (format: XXX/XXXX/XXX/XXXXXX, up to 20 characters).Available for Active Residents and Visitors
result.data.immigrationFile.issuePlacestringEmirate or location where the file was issued (up to 100 characters).Available for Active Residents and Visitors
result.data.immigrationFile.issueDatestringImmigration file issue date (YYYY-MM-DD, 10 characters).Available for Active Residents and Visitors
result.data.immigrationFile.expiryDatestringImmigration file expiry date (YYYY-MM-DD, 10 characters).Available for Active Residents and Visitors
result.data.immigrationFile.workFlagbooleanIndicates if the tourist/visitor has a work permit. true for tourists with work authorization, false otherwise.Available for Tourists and Visitors
Person ClassificationVisa Type EnglishVisa Type Arabic
GOLDENRESIDENT RESIDENCEاقامة
GOLDENSERVICEعمل/هـ
GREENRESIDENT RESIDENCEاقامة
GREENSERVICEعمل/هـ
RESIDENCEWORK RESIDENCEعمل
RESIDENCERESIDENT RESIDENCEاقامة
RESIDENCESERVICEعمل/هـ
VISITOREMPLOYMENTعمل
VISITORPRIVATEأذن خاص
VISITOREMPLOYMENT/IMMعمل/هـ
VISITORMULTI S.TERM VISIT/LEISURE/CITIZENS/SOME COUNTRIESزيارة قصيرة لعدة سفرات ترفيه لرعايا بعض الدول
VISITORENTRY PERMIT(RECIPROCITY) FOR 30 DAYSتأشيرات المعاملة بالمثل (30) يوم
VISITORTRANSIT VISA( 48 hrs)48 ساعة
VISITOR96 HRS96 ساعة
VISITORTOURIST CABIN CREW ENTRY PERMITأذن دخول للعاملين على متن السفن السياحية
VISITORSGI L.TERM ENTRY PERMIT/EMPLOYMENT (MISSION)إذن دخول زيارة طويلة لسفرة واحدة عمل (مهمة عمل)
VISITORPRIVATE BOAT CABIN CREW ENTRY PERMITأذن دخول طاقم مركب النزهه
VISITORRECIPROCITYتأشيرات المعاملة بالمثل
VISITORSHORT VISIT ENTRY PERMIT(30 DAYS INVITATION)إذن دخول للزيارة ( دعوة ) قصيرة 30 يوم
VISITORS.Term Entry Permit of Courtesy/Embassyإذن دخول قصيرة مجاملة / سفارة
VISITORENTRY PERMIT/EUROPEAN CITIZENS(SCHENGEN)أذن دخول لرعايا الدول الأوروبية ( منطقة الشنغن )
VISITORVISA FOR INDIAN IN SPECIAL COUNTRIES 14 DAYSتأشيرة رعايا الهند في بعض الدول 14 يوم
VISITORENTRY PERMIT FOR ٌ ٌREPUBLIC OF MAURITIUS CITIZENSإذن دخول لرعايا جمهورية موريشيوس
VISITORMEDICAL TREATMENTإذن دخول للعلاج لسفرة واحدة
VISITORGCC Accompanyمجلس تعاون / مـرافـق
VISITORGCC Residentمـجـلس تـعاون / مـقـيـم
VISITORSINGL Entry Visa for(SA)90 Days /180 Daysتأشيرة سفرة واحدة إتفاقيات خاصه90 يوم خلال 180 يوم
VISITORMulti Entry Visa for (S A) 90 Days / 12 Monthsتأشيرة عدة سفرات إتفاقيات خاصه 90 يوم خلال 12 شهر
VISITORVISA FOR JOB SEEKERSتأشيرة الباحثين عن العمل
VISITORMulti S. Term Entry Permit Visit/Tourismإذن دخول زيارة قصيرة لعدة سفرات سياحية
VISITORSgl L. Term Entry Permit Visit/Tourismإذن دخول زيارة طويلة لسفرة واحدة سياحية
VISITOREmergency Entry Permitإذن دخول طارئ (إلغاء رحلات الاعطال/ ظروف جوية)
VISITORSgl S. Term Entry Permit Visit/Leisureإذن دخول زيارة قصيرة لسفرة واحدة ترفيه
VISITORSgl L. Term Entry Permit Visit/Leisureإذن دخول زيارة طويلة لسفرة واحدة ترفيه
VISITORSgl S. Term Entry Permit Visit/Tourismإذن دخول زيارة قصيرة لسفرة واحدة سياحية
VISITORCabin Crew Entry Permitإذن دخول أطقم الطائرات / سفن
VISITORSgl L. Term Entry Permit Visit/Employment (GOVT)إذن دخول زيارة طويلة لسفرة واحدة عمل (الحكومية)
VISITORENTRY PERMIT(RECIPROCITY) FOR 180 DAYSتأشيرات المعاملة بالمثل (180) يوم
VISITORMulti L. Term Entry Permit Visit/Tourism\5yearأذن دخول سياحة متعددة السفرات لمدة 5 سنوات
VISITORTourist visa - single trip - 60 daysتأشيرة سياحة - سفرة واحدة - 60 يوم
VISITORTourist visa - multiple trips - 60 daysتأشيرة سياحة - عدة سفرات - 60 يوم
VISITORVisa - visit a relative or friend 30 daysتأشيرة - سفرة واحدة - زيارة قريب أو صديق 30 يوم
VISITORVisa - Visit Relative or Friend 60 Daysتأشيرة - سفرة واحدة - زيارة قريب أو صديق 60 يوم
VISITORVisa - Visit a relative or friend 60 daysتأشيرة - عدة سفرات - زيارة قريب أو صديق 60 يوم
VISITORVisa - Visit Relative or Friend 90 Daysتأشيرة - سفرة واحدة - زيارة قريب أو صديق 90 يوم
VISITORVisa - 60 Days Explore Business Opportunitiesتأشيرة - إستكشاف فرص العمل 60 يوم
VISITORVisa - Explore Business Opportunities 90 Daysتأشيرة - إستكشاف فرص العمل 90 يوم
VISITORVisa - Explore Business Opportunities 120 Daysتأشيرة - إستكشاف فرص العمل 120 يوم
VISITORVISA FOR INDIAN IN SPECIAL COUNTRIES 60 DAYSتأشيرة رعايا الهند في بعض الدول 60 يوم
This is not an exhaustive list. Additional visa types may be returned depending on the immigration record. Stay periods and visa types are subject to change as per UAE visa and federal policy updates.

Active Visa (result.data.activeVisa)

null for UAE/GCC citizens who do not require visas.
FieldTypeDescriptionData Availability
result.data.activeVisa.visaTypeenumVisa category: Work, Visit, Residence, Transit, Student, Mission.Available for Active Visitors
result.data.activeVisa.visaDepartmentstringGovernment department that issued the visa (up to 200 characters).Available for Active Visitors
result.data.activeVisa.passportNostringPassport number linked to this visa (up to 20 characters).Available for Active Visitors
result.data.activeVisa.passportExpiryDatestringExpiry date of the linked passport (YYYY-MM-DD).Available for Active Visitors
result.data.activeVisa.passportIssuePlacestringCity or country where the linked passport was issued (up to 100 characters).Available for Active Visitors
result.data.activeVisa.visaStatusenumCurrent visa status: USED, CLOSED, CANCELLED, CHANGE STATUS, EXTENDED, VIOLATED.Available for Active Visitors
result.data.activeVisa.issueDatestringVisa issue date (YYYY-MM-DD).Available for Active Visitors
result.data.activeVisa.createdDatestringDate the visa record was created (YYYY-MM-DD).Available for Active Visitors
result.data.activeVisa.validityDatestringDate until which the visa is valid for entry (YYYY-MM-DD).Available for Active Visitors
result.data.activeVisa.expiryDatestringVisa expiry date (YYYY-MM-DD).Available for Active Visitors
The visaStatus field on the active visa record indicates the current lifecycle state of the visa:
StatusEvent
UsedAfter valid entry
ClosedAfter valid exit
CancelledAfter cancellation
Change StatusAfter change status inside the country
ExtendedAfter do the extension for the visa
ViolatedIf the visa holder start violation

Document Images (result.data.documents)

Base64-encoded document images. Individual fields are empty strings when the corresponding document was not captured during the journey. Store these securely in encrypted storage.
FieldTypeDescriptionData Availability
result.data.documents.passportImagestring (Base64)JPEG, typically 50–500 KB. Base64-encoded passport scan. Empty string when passport was not used.Available for all scenarios
result.data.documents.personFacestring (Base64)JPEG, typically 30–200 KB. Base64-encoded facial photograph captured during selfie step. Always present for completed journeys.Available for all scenarios
result.data.documents.digitalEIDstring (Base64)PDF. Base64-encoded digital Emirates ID. Empty string when Emirates ID was not used.Available for UAE Nationals and Residents
result.data.documents.digitalSignaturestring (Base64)TIFF, typically 5–50 KB. Base64-encoded digital signature. Empty string when not captured.Available for UAE National, Residents and Ex-Residents
result.data.documents.activeVisastring (Base64)JPEG, typically 50–500 KB. Base64-encoded active visa document. Empty string for UAE/GCC citizens or when no visa image is on record.Available for Active Residents
result.data.documents.touristIDstring (Base64)PDF, typically 5–100 KB. Base64-encoded tourist identification document. Empty string when tourist ID was not captured.Available for Tourists & GCC Visitors

Next Steps

1
Save the uaeKycId
2
Store the customer’s unique identifier — you’ll need it for future REKYC and AUTHORISE journeys.
3
Store data within 24 hours
4
Customer data expires after 24 hours. Extract and persist everything you need into your own database.
5
Store document images securely
6
The documents object contains sensitive images. Decode and store them in encrypted storage per your data protection policies.
7
Verify the response signature
8
Use the signature field to verify response integrity before storing any data.
All date fields use YYYY-MM-DD format. Fields suffixed with Ar contain Arabic text, En contains English text.
{
  "result": {
    "success": true,
    "message": "Customer details fetched successfully",
    "data": {
      "uaeKycId": "139",
      "uidNumber": -144,
      "uaeKycCertificate": "",      
      "touristInfo": {
        "touristId": "1234"
      },

      "personalInfo": {
        "genderAr": "ذكر",
        "genderEn": "Male",
        "mobileNo": "0000000000",
        "insideUAE": "No",
        "fullNameAr": "جون أحمد دو",
        "fullNameEn": "John Ahmed Doe",
        "dateOfBirth": "1990-01-15",
        "firstNameAr": "جون",
        "firstNameEn": "John",
        "personClass": "Resident",
        "familyNameAr": "دو",
        "familyNameEn": "Doe",
        "motherNameAr": "فاطمة",
        "motherNameEn": "Fatima",
        "occupationAr": "مهندس",
        "occupationEn": "Engineer",
        "secondNameAr": "أحمد",
        "secondNameEn": "Ahmed",
        "placeOfBirthAr": "مومباي",
        "placeOfBirthEn": "Mumbai",
        "maritalStatusAr": "أعزب",
        "maritalStatusEn": "SINGLE",
        "hijriDateOfBirth": "1410-06-18",
        "immigrationStatus": "ACTIVE",
        "currentNationality": "IND",
        "personClassification": "RESIDENCE"
      },

      "travelDetail": {
         "isInsideUAE": true,
        "travelDate": "2024-12-01",
        "travelTime": "14:30:23",
        "travelType": "Inside UAE",
        "travelDocumentNo": "A1234567",
        "travelDocumentIssueDate": "2020-03-10",
        "travelDocumentExpiryDate": "2030-03-09"
      },
      "residenceInfo": {
        "issueDate": "2023-05-01",
        "documentNo": "201/2023/1234567",
        "expiryDate": "2033-05-01",
        "sponsorNameAr": "شركة أ ب ج ذ.م.م",
        "sponsorNameEn": "ABC Company LLC",
        "emiratesIdNumber": "784200058404151",
        "residenceClassAr": "إقامة عمل",
        "residenceClassEn": "WORK RESIDENCE",
        "residenceDepartmentAr": "غير معروف",
        "residenceDepartmentEn": "UNKNOWN",
        "accompanyCount": "0"
      },

      "activePassport": {
        "issueDate": "2020-03-10",
        "documentNo": "A1234567",
        "expiryDate": "2030-03-09",
        "documentType": "ORDINARY PASSPORT",
        "documentNationality": "India",
        "documentIssueCountry": "India",
        "documentNationalityAbbr": "IND",
        "documentIssueCountryAbbr": "IND"
      },

      "sponsorDetails": {
        "nameAr": "شركة أ ب ج ذ.م.م",
        "nameEn": "ABC Company LLC",
        "departmentAr": "غير معروف",
        "departmentEn": "UNKNOWN",
        "sponsorTypeAr": "شركات",
        "sponsorTypeEn": "COMPANIES",
        "sponsorNationality": "United Arab Emirates",
        "sponsorNationalityAbbr": "ARE",
        "sponsorIdn": "123456789",
        "tradeLicense": "TL-12345",
      },
      "immigrationFile": {
        "status": "ACTIVE",
        "issueDate": "2023-05-01",
        "expiryDate": "2025-04-30",
        "fileNumber": "101/2025/123/123456",
        "fileTypeAr": "تصريح دخول متعدد قصير المدة زيارة/سياحة",
        "fileTypeEn": "Multi S. Term Entry Permit Visit/Tourism",
        "issuePlace": "FEDERAL AUTHORITY FOR IDENTITY & CITIZENSHIP \\ ABU DHABI"
      },

  "personContactDetails": {
    "poBox": "12345",
    "areaAr": "البرشاء",
    "areaEn": "Al Barsha",
    "cityAr": "دبي",
    "cityEn": "Dubai",
    "mobileNo": "+971501234567",
    "emirateAr": "دبي",
    "emirateEn": "DUBAI",
    "streetAr": "شارع الشيخ زايد",
    "streetEn": "Sheikh Zayed Road",
    "homePhone": "+97141234567",
    "workPhone": "+97142345678"
  },

  "sponsorContactDetails": {
    "poBox": "54321",
    "emirateAr": "دبي",
    "emirateEn": "DUBAI",
    "cityAr": "دبي",
    "cityEn": "Dubai",
    "areaAr": "ديرة",
    "areaEn": "Deira",
    "streetAr": "شارع بني ياس",
    "streetEn": "Baniyas Road",
    "email": "info@abccompany.ae",
    "mobileNo": "+971501234567",
    "workPhone": "+97142345678",
    "homePhone": "+97141234567"
  },
      "documents": {
        "passportImage": "",
        "personFace": "",
        "digitalSignature": "",
        "digitalEID": ""
      }
    },
    "createdAt": 1776343071887,
    "meta": {
      "apiEndpoint": "/otk-service/customer-details",
      "serverTimestamp": 1776343497975,
      "journeyType": "ONBOARDING",
      "journeyToken": "13a7efd7-d32d-4392-acd8-2e149e58d12b"
    },
    "errors": [],
    "warnings": [
      {
        "code": "UAEKYC-WARN-ICP-002",
        "type": "ICP",
        "message": "Document & ICP record data mismatch for document expiry"
      }
    ]
  },
  "signature": ""
}

Sample Response Files

For additional reference, sample API response files are available that demonstrate how customer data varies by customer type:
Sample UAE Citizen Response (assets/local.json)
{
  "result": {
    "success": true,
    "message": "Customer details have been successfully retrieved.",
    "data": {
        "uaeKycId": "123456789",
        "uidNumber": 1234567,
        "uaeKycCertificate": "data:application/pdf;base64,JVBERi0xLjQ...",
        "personalInfo": {
            "genderEn": "MALE",
            "genderAr": "ذكر",
            "mobileNo": "+971501234567",
            "insideUAE": "Yes",
            "fullNameAr": "جون أحمد دو",
            "fullNameEn": "John Ahmed Doe",
            "dateOfBirth": "1990-01-15",
            "firstNameAr": "جون",
            "firstNameEn": "John",
            "personClass": "UAE Citizen",
            "familyNameAr": "دو",
            "familyNameEn": "Doe",
            "occupationAr": "مهندس",
            "occupationEn": "Engineer",
            "secondNameAr": "أحمد",
            "secondNameEn": "Ahmed",
            "placeOfBirthAr": "العين",
            "placeOfBirthEn": "AL AIN",
            "maritalStatusEn": "SINGLE",
            "maritalStatusAr": "أعزب",
            "immigrationStatus": "NA",
            "hijriDateOfBirth": "1410-06-18",
            "motherNameAr": "فاطمة",
            "motherNameEn": "Fatima",
            "currentNationality": "ARE",
            "personClassification": "LOCAL"
        },
        "travelDetail": {
            "travelType": "Inside UAE",
            "travelTime": "14:30:23",
            "travelDate": "2024-12-01",
            "isInsideUAE": true,
            "travelDocumentNo": "A1234567",
            "travelDocumentIssueDate": "2020-03-10",
            "travelDocumentExpiryDate": "2030-03-09"
        },
        "residenceInfo": {
            "issueDate": "2025-10-07",
            "documentNo": "123456789",
            "expiryDate": "2030-10-06",
            "emiratesIdNumber": "784202512345678"
        },
        "activePassport": {
            "issueDate": "2020-03-10",
            "documentNo": "A1234567",
            "expiryDate": "2030-03-09",
            "documentType": "ORDINARY PASSPORT",
            "documentNationality": "UNITED ARAB EMIRATES",
            "documentIssueCountry": "UNITED ARAB EMIRATES",
            "documentNationalityAbbr": "ARE",
            "documentIssueCountryAbbr": "ARE"
        },
        "immigrationFile": {
            "status": "NA"
        },
        "personContactDetails": {
            "poBox": "12345",
            "areaAr": "البرشاء",
            "areaEn": "Al Barsha",
            "cityAr": "دبي",
            "cityEn": "Dubai",
            "mobileNo": "+971501234567",
            "emirateAr": "دبي",
            "emirateEn": "DUBAI",
            "streetAr": "شارع الشيخ زايد",
            "streetEn": "Sheikh Zayed Road",
            "homePhone": "+97141234567",
            "workPhone": "+97142345678"
        },
        "documents": {
            "personFace": "data:image/jpeg;base64,/9j/4AAQ...",
            "passportImage": "data:image/jpeg;base64,/9j/4AAQ...",
            "digitalEID": "data:application/pdf;base64,JVBERi0xLjQ...",
            "digitalSignature": "data:image/tiff;base64,SUkqAA..."
        }
    },
    "createdAt": 1737018028786,
    "meta": {
        "apiEndpoint": "/otk-service/customer-details/:journeyToken",
        "serverTimestamp": 1739585925000,
        "journeyType": "ONBOARDING",
        "journeyToken": "550e8400-e29b-41d4-a716-446655440000"
    },
    "errors": [],
    "warnings": []
  },
  "signature": ""
}
These sample files are provided for development and testing purposes. Actual API responses will contain real customer data with the same structure but different values.