Emirates V2

Endpoint Overview

POST /api/v1/uae/emirates-verification-v2

Description

The Emirates ID Verification V2 API allows you to validate and retrieve information from Emirates ID cards by providing the ID number, date of birth, and nationality of the cardholder. This API performs a comprehensive verification against official UAE records and returns detailed information about the Emirates ID, including its status, issue and expiry dates, unified number, and associated file number.

Key Benefits

Instant verification of Emirates ID authenticity against official records

Comprehensive data retrieval including issue date, expiry date, and unified number

Supports verification for cardholders of all nationalities

Helps prevent identity fraud and ensures regulatory compliance

Use Cases

Financial Services

Government Services

Corporate Sector

Customer onboarding for banking and financial institutions

KYC verification for loan and credit card applications

Identity verification for opening investment accounts

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

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

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token authentication using JWT
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	Emirates ID number of the cardholder
date_of_birth	String	Yes	Date of birth in "YYYY-MM-DD" format
current_nationality	Enum	Yes	Nationality of the cardholder (see supported values below)

Example Request

{
    "id_number": "7841999479019",
    "date_of_birth": "1805-06-01",
    "current_nationality": "india"
}

Supported Nationality Values

The API supports a comprehensive list of 200+ nationalities from around the world. All nationality values must be provided in lowercase with underscores separating words:

afghanistan, albania, algeria, andorra, angola, antigua_and_barbuda, argentina, armenia, australia, austria, azerbaijan, bahamas, bahrain, bangladesh, barbados, belarus, belgium, belize, benin, bermuda, bhutan, bolivia, bosnia_and_herzegovina, botswana, brazil, brunei_darussalam, bulgaria, burkina_faso, burundi, cabo_verde, cambodia, cameroon, canada, cayman_islands, central_african_republic, chad, chile, china, colombia, commonwealth_of_dominica, comoros, congo, costa_rica, cote_d_ivoire, croatia, cuba, cyprus, czech_republic, democratic_peoples_republic_of_korea, democratic_republic_of_the_congo, denmark, djibouti, dominican_republic, ecuador, egypt, el_salvador, equatorial_guinea, eritrea, estonia, ethiopia, fiji, finland, france, french_guiana, gabon, gambia, georgia, germany, ghana, greece, greenland, grenada, guatemala, guinea, guinea_bissau, guyana, haiti, holy_see_vatican, honduras, hong_kong_special_administrative_region, hungary, iceland, india, indonesia, iran_islamic_republic_of, iraq, ireland, israel, italy, jamaica, japan, jordan, kazakhstan, kenya, kiribati, kosovo, kuwait, kyrgyzstan, laos_peoples_democratic_republic, latvia, latvia_resident, lebanon, lesotho, liberia, libya, liechtenstein, lithuania, luxembourg, macao, madagascar, malawi, malaysia, maldives, mali, malta, maqdonia, marshall_islands, martinique, mauritania, mauritius, mexico, monaco, morocco, micronesia_federated_states_of, mongolia, montenegro, mozambique, myanmar, namibia, nauru, nepal, netherlands, new_caledonia, new_zealand, nicaragua, niger, nigeria, northern_mariana_islands, norway, oman, pakistan, palau, panama, papua_new_guinea, paraguay, peru, philippines, poland, portugal, puerto_rico, qatar, republic_of_korea, republic_of_moldova, republic_of_somaliland, romania, russian_federation, rwanda, saint_helena, saint_kitts_and_nevis, saint_lucia, saint_vincent_and_the_grenadines, samoa, san_marino, sao_tome_and_principe, saudi_arabia, senegal, serbia, seychelles, sierra_leone, singapore, slovakia, slovenia, solomon_islands, somalia, south_africa, south_sudan, spain, sri_lanka, state_of_palestine, sudan, suriname, swaziland, sweden, switzerland, syrian_arab_republic, taiwan, tajikistan, thailand, timor_leste, togo, tonga, trinidad_and_tobago, tunisia, turkey, turkmenistan, tuvalu, uganda, ukraine, united_arab_emirates, united_kingdom_uk, united_republic_of_tanzania, united_states_of_america, uruguay, uzbekistan, vanuatu, venezuela, viet_nam, yemen, zambia, zimbabwe

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the verification result data
data.client_id	String	Unique identifier for the verification request
data.date_of_birth	String	Date of birth of Emirates ID holder in "YYYY-MM-DD" format
data.current_nationality	String	Current nationality of Emirates ID holder
data.issue_date	String	ID issue date in "YYYY-MM-DD" format
data.expire_date	String	ID expiry date in "YYYY-MM-DD" format
data.unified_number	String	Unified number of Emirates ID
data.passport_expiry_date	String	Passport expiry date in "YYYY-MM-DD" format
data.status	String	Emirates ID status (e.g., "ACTIVE")
data.file_number	String	File number of Emirates ID
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the verification was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": {
        "client_id": "uae_emirates_v2_pOdkrjHKwCKbvNmoPrxC",
        "date_of_birth": "1999-06-01",
        "current_nationality": "india",
        "issue_date": "2000-00-00",
        "expire_date": "2004-06-00",
        "unified_number": "57500038",
        "passport_expiry_date": "2000-08-29",
        "status": "ACTIVE",
        "file_number": "101/9383"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid ID

Authentication Error

Data Mismatch

{
    "status_code": 400,
    "success": false,
    "message": "Invalid Emirates ID number provided",
    "message_code": "invalid_id_number"
}

The Emirates ID number provided is invalid or does not exist in the system.

Integration Best Practices

Security Recommendations

Store API keys securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Rotate JWT tokens periodically and implement token expiration

User Experience Guidelines

Implement proper validation for Emirates ID format before submission

Provide clear error messages to end-users when verification fails

Consider implementing a retry mechanism with backoff for temporary failures

Cache verification results (where appropriate) to improve response times

Code Samples

cURL

Python

Node.js

Compliance and Legal Considerations

This API processes personal identification data and must be used in compliance with UAE data protection laws and regulations. Ensure you have proper consent from individuals before verifying their Emirates ID information. The API should only be used for legitimate verification purposes such as KYC, fraud prevention, or regulatory compliance.

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/emirates-verification-v2' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "7841999479019", "date_of_birth": "1805-06-01", "current_nationality": "india" }'

{ "data": { "client_id": "uae_emirates_v2_pOdkrjHKwCKbvNmoPrxC", "date_of_birth": "1999-06-01", "current_nationality": "india", "issue_date": "2000-00-00", "expire_date": "2004-06-00", "unified_number": "57500038", "passport_expiry_date": "2000-08-29", "status": "ACTIVE", "file_number": "101/9383" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Supported Nationality Values#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses