UAE Visa Verification

Endpoint Overview

POST /api/v1/uae/visa-verification

Description

The UAE Visa Verification API enables real-time verification of visa records in the United Arab Emirates using passport credentials. This endpoint queries official UAE immigration databases to retrieve comprehensive visa information including status, validity periods, unified numbers, and file details. The API provides instant access to critical visa data, eliminating manual verification processes and reducing processing times from days to seconds.

This service is essential for organizations that need to validate visa authenticity, check visa status, or verify immigration compliance for individuals traveling to or residing in the UAE.

Key Benefits

Real-Time Verification: Instant access to UAE visa records with sub-second response times

Comprehensive Data: Retrieve detailed visa information including status, file numbers, unified numbers, and validity dates

Regulatory Compliance: Ensure compliance with UAE immigration requirements through accurate visa status verification

Fraud Prevention: Authenticate visa documents and detect fraudulent or expired visa applications

Use Cases

Travel & Hospitality

HR & Employment

Financial Services

Hotel Check-ins: Verify guest visa status during hotel registration to ensure compliance with UAE regulations

Travel Booking Validation: Confirm visa validity before processing flight or tour bookings to the UAE

Event Management: Validate visa status for international attendees at conferences and exhibitions in the UAE

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.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for API authentication. Format: `Bearer {JWT_TOKEN}`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
passport_number	string	Yes	The passport number to verify. Must match the format specified by the issuing country. Example: "S1234567"
passport_expiry_date	string	Yes	Passport expiration date in ISO 8601 format (YYYY-MM-DD). Example: "2028-01-01"
current_nationality	string	Yes	Current nationality of the passport holder in lowercase. Example: "india"

Example Request

{
    "passport_number": "S1234567",
    "passport_expiry_date": "2028-01-01",
    "current_nationality": "india"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Container object for visa verification results
data.client_id	string	Unique identifier for the verification request generated by Surepass
data.passport_number	string	Passport number that was verified
data.passport_expiry_date	string	Passport expiry date in ISO 8601 format
data.current_nationality	string	Nationality of the passport holder
data.issue_date	string	Date when the visa was issued in ISO 8601 format
data.file_expire_date	string	Date when the visa file expires in ISO 8601 format
data.unified_number	string	UAE unified identification number associated with the visa
data.departure_date	string	Date of departure or visa exit date in ISO 8601 format
data.status	string	Current status of the visa. Possible values: "CLOSED", "ACTIVE", "EXPIRED", "CANCELLED"
data.file_number	string	Official UAE immigration file number for the visa record
status_code	integer	HTTP status code of the response (200 for success)
success	boolean	Indicates whether the API request was successful
message	string	Human-readable message describing the result
message_code	string	Machine-readable code for the response message

Example Successful Response

{
    "data": {
        "client_id": "uae_emirates_visa_verification_mdufrOROYvgYndytRlao",
        "passport_number": "S1234567",
        "passport_expiry_date": "2028-01-01",
        "current_nationality": "india",
        "issue_date": "2024-05-04",
        "file_expire_date": "2024-05-28",
        "unified_number": "226110589",
        "departure_date": "2024-05-28",
        "status": "CLOSED",
        "file_number": "304/2024/29/6007"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Credentials

Validation Error

{
    "status_code": 401,
    "success": false,
    "message": "Invalid authentication token",
    "message_code": "unauthorized"
}

Returned when the Bearer token is missing, expired, or invalid. Verify your JWT token and ensure it's correctly included in the Authorization header.

Integration Best Practices

Security Recommendations

Secure Token Storage: Store JWT tokens securely using environment variables or secure vault solutions. Never hardcode tokens in your application code.

HTTPS Only: Always use HTTPS for API requests to encrypt data in transit and protect sensitive passport information.

Token Rotation: Implement regular token rotation policies and refresh tokens before expiration to maintain uninterrupted service.

Data Minimization: Only request and store visa verification data when absolutely necessary for your business process.

Access Control: Limit API access to authorized personnel and implement role-based access control in your applications.

User Experience Guidelines

Clear User Consent: Inform users that their passport information will be used for visa verification and obtain explicit consent.

Error Handling: Display user-friendly error messages without exposing technical details or sensitive information.

Loading States: Implement visual feedback during API calls to manage user expectations during verification (typically 1-3 seconds).

Data Accuracy: Validate passport input format on the client side to reduce API errors and improve user experience.

Privacy Communication: Clearly communicate how passport data is processed, stored, and protected in compliance with data protection regulations.

Code Samples

cURL

Python

Node.js

Related APIs

Passport Verification API - Verify passport authenticity and extract document details for identity validation

UAE ID Verification API - Validate UAE Emirates ID cards for residents and citizens

International Background Check API - Comprehensive background verification including visa history and immigration records

Document OCR API - Extract data from passport images to auto-populate verification requests

Compliance and Legal Considerations

This API accesses official UAE government immigration databases. Users must ensure compliance with:

UAE Data Protection Laws: Handle all visa and passport data in accordance with UAE Federal Law on Personal Data Protection

User Consent Requirements: Obtain explicit consent from individuals before verifying their visa information

Purpose Limitation: Use verification data only for legitimate business purposes such as employment verification, accommodation booking, or compliance checks

Data Retention: Do not store visa verification results longer than necessary for your business purpose

Cross-Border Data Transfer: Be aware of restrictions when transferring UAE visa data across international borders

Authorized Use Only: This API is intended for legitimate verification purposes. Unauthorized use may violate UAE immigration laws

Always consult with legal counsel to ensure your use case complies with applicable regulations.

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/visa-verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "passport_number": "S1234567", "passport_expiry_date": "2028-01-01", "current_nationality": "india" }'

{ "data": { "client_id": "uae_emirates_visa_verification_mdufrOROYvgYndytRlao", "passport_number": "S1234567", "passport_expiry_date": "2028-01-01", "current_nationality": "india", "issue_date": "2024-05-04", "file_expire_date": "2024-05-28", "unified_number": "226110589", "departure_date": "2024-05-28", "status": "CLOSED", "file_number": "304/2024/29/6007" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

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