Qatar Visa Verification

Endpoint Overview

POST /api/v1/global/qa/qatar-visa-verification

Description

The Qatar Visa Verification API allows you to verify visa details for individuals holding Qatari visas. By providing a valid visa number and nationality, clients can retrieve key details such as visa type, status, validity period, and personal information of the visa holder. This helps streamline onboarding, compliance, and identity validation workflows for individuals traveling to or residing in Qatar.

Key Benefits

Real-time verification of Qatar visa information

Reduces fraud by confirming visa authenticity

Quick integration with onboarding workflows

Enhances regulatory compliance for KYC/AML

Use Cases

Travel & Immigration

Banking & Fintech

Employment & Recruitment

Automate visa checks during flight or hotel booking.

Validate visa details during immigration pre-clearance.

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 (JWT)
Content-Type	Yes	Must be `application/json`

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	Qatar visa number
nationality	string	Yes	Nationality in lowercase (e.g. `india`)

Example Request

{
    "id_number": "382023226989",
    "nationality": "india"
}

Process Response

Response Parameters

Parameter	Type	Description
data.client_id	string	Unique ID for API request tracking
data.visa_number	string	Visa number as provided
data.nationality	string	Nationality in uppercase
data.name	string	Full name of visa holder
data.passport_number	string	Passport number
data.description_of_visa_owner	string	Relationship to passport
data.gender	string	Gender of visa holder
data.visa_type	string	Type of visa issued
data.travel_index	string	Entry category (e.g. MULTI ENTRY)
data.stay_duration	string	Duration of allowed stay
data.date_of_issue	string	Visa issue date (YYYY-MM-DD)
data.visa_validity	string	Visa expiry date (YYYY-MM-DD)
data.visa_status	string	Current visa status
status_code	number	HTTP status code
success	bool	Indicates if request was successful
message	string	Human-readable message
message_code	string	Machine-readable status code

Example Successful Response

{
    "data": {
        "client_id": "qatar_visa_verification_OoZQnPbttJknjwpHitTa",
        "visa_number": "382023226989",
        "nationality": "INDIA",
        "name": "DHARMENDRA SAH BHADAI  SAH",
        "passport_number": "S4675522",
        "description_of_visa_owner": "Passport Owner",
        "gender": "Male",
        "visa_type": "WORK - MULTI ENTRY",
        "travel_index": "MULTI ENTRY",
        "stay_duration": "3-MONTH",
        "date_of_issue": "2023-05-24",
        "visa_validity": "2025-08-24",
        "visa_status": "USED INSIDE COUNTRY"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Token

Missing Fields

Server Error

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

The JWT token is missing, incorrect, or expired.

Integration Best Practices

Security Recommendations

Always use HTTPS to prevent data leakage.

Store your API keys and JWT tokens securely on the server-side.

Monitor token usage and rotate tokens periodically.

User Experience Guidelines

Display user-friendly error messages when validation fails.

Validate nationality input before making requests.

Show loading indicators during API calls for better UX.

Code Samples

cURL

Python

Node.js

Related APIs

Visa Verification Country List: Fetch supported nationalities for visa verification.

Passport OCR: Extracts data from passport images.

UAE Visa Verification: Verify visa status for United Arab Emirates.

Compliance and Legal Considerations

Ensure user consent is obtained before verifying visa data. Comply with local regulations such as GDPR or country-specific data protection laws. Only authorized use is permitted under contractual agreements with Surepass.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/global/qa/qatar-visa-verification' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "382023226989", "nationality": "india" }'

{ "data": { "client_id": "qatar_visa_verification_OoZQnPbttJknjwpHitTa", "visa_number": "382023226989", "nationality": "INDIA", "name": "DHARMENDRA SAH BHADAI SAH", "passport_number": "S4675522", "description_of_visa_owner": "Passport Owner", "gender": "Male", "visa_type": "WORK - MULTI ENTRY", "travel_index": "MULTI ENTRY", "stay_duration": "3-MONTH", "date_of_issue": "2023-05-24", "visa_validity": "2025-08-24", "visa_status": "USED INSIDE COUNTRY" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Qatar Visa Verification

Qatar Visa 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

Qatar Visa 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