Emirates Verification

Endpoint Overview

POST /api/v1/uae/emirates-verification

Description

The Emirates Verification API allows you to validate and retrieve information associated with an Emirates ID number. This endpoint performs a real-time verification against official UAE records, returning key details such as service transaction name, issue date, administration information, and associated fees. This verification helps businesses confirm the authenticity of Emirates ID documents and extract verified information for KYC processes.

Key Benefits

Instant verification of Emirates ID numbers against official records

Reduces manual verification efforts and human error

Enhances KYC compliance for UAE-based operations

Streamlines customer onboarding with verified identity information

Use Cases

Financial Services

Telecommunications

Government Services

Customer onboarding for banking and financial services

Identity verification for loan and credit card applications

Compliance with UAE financial regulatory requirements

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 format
Content-Type	Yes	Application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	Emirates ID number to be verified

Example Request

{
    "id_number": "784199514290842"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the verification result data
data.client_id	String	Unique identifier for the client making the request
data.id_number	String	Emirates ID number that was verified
data.service_transaction_name	String	Service transaction name as per Emirates ID details
data.request_date	String	Emirates ID request date in "YYYY-MM-DD" format
data.issue_date	String	Emirates ID issuing date in "YYYY-MM-DD" format
data.administration	String	Administration name as per Emirates ID details
data.application_fees	Float	Application fees associated with the Emirates ID
data.approval_date	String	Emirates ID approval date in "YYYY-MM-DD" format
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the verification was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code for the result message

Example Successful Response

{
    "data": {
        "client_id": "uae_emirates_UtSQbbmznbBKQjglaHxl",
        "id_number": "124199500000",
        "service_transaction_name": "XYZ ISSUANCE",
        "request_date": "2022-00-00",
        "issue_date": "2022-00-00",
        "administration": "AL",
        "application_fees": 53.00,
        "approval_date": "2022-00-00"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid ID Number

ID Not Found

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid Emirates ID number format",
    "message_code": "invalid_id_format"
}

The Emirates ID number provided is not in the correct format or fails basic validation checks.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Implement rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Provide clear feedback to users when verification fails

Implement a retry mechanism with appropriate backoff for temporary failures

Cache verification results (where appropriate) to improve response times

Display verification status clearly in your interface

Code Samples

cURL

Python

Node.js

Related APIs

UAE Passport Verification: Verify UAE passport details against official records

UAE Visa Verification: Validate UAE visa information and status

UAE Address Verification: Confirm residential address details in the UAE

Compliance and Legal Considerations

When using this API, ensure compliance with UAE data protection laws and regulations. The Emirates ID contains personal information that must be handled according to UAE's privacy regulations. Obtain proper consent from individuals before verifying their Emirates ID information. This API should only be used for legitimate business purposes such as KYC, fraud prevention, or regulatory compliance.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/uae/emirates-verification' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "784199514290842" }'

{ "data": { "client_id": "uae_emirates_UtSQbbmznbBKQjglaHxl", "id_number": "124199500000", "service_transaction_name": "XYZ ISSUANCE", "request_date": "2022-00-00", "issue_date": "2022-00-00", "administration": "AL", "application_fees": 053.00, "approval_date": "2022-00-00" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Emirates Verification

Emirates Verification#

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

Emirates Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples