Oman Visa Verification

Endpoint Overview

POST /api/v1/oman/visa-verification

Description

The Oman Visa Verification API allows you to verify the status of an Oman visa application by providing the application number, passport number, and country of the applicant. This API returns comprehensive visa status information including approval status and a link to the application PDF document.

Key Benefits

Instant verification of Oman visa application status

Access to official visa application documentation

Streamlined visa status checking for travel agencies and immigration services

Secure and reliable verification through official channels

Use Cases

Travel & Tourism

Immigration Services

Hospitality

Travel agencies verifying client visa status before finalizing travel arrangements

Tour operators confirming visa approval for group travel to Oman

Online travel booking platforms integrating visa verification in their booking flow

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
application_number	String	Yes	The visa application number to verify
document_number	String	Yes	The passport number of the applicant
country	String	Yes	The country name of the applicant

Example Request

{
    "application_number": "123456789",
    "document_number": "A1234567",
    "country": "india"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the client
data.application_number	String	The visa application number that was verified
data.document_number	String	The passport number of the applicant
data.country	String	The country name of the applicant
data.status	String	Current status of the visa application (e.g., "Approved")
data.application_pdf	String	URL to download the visa application PDF
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code for the message

Example Successful Response

{
    "data": {
        "client_id": "oman_visa_RcllxMTkOaivvhrUybxC",
        "application_number": "123456789",
        "document_number": "A123456",
        "country": "india",
        "status": "Approved",
        "application_pdf": "https://aadhaar-kyc-docs.s3.amazonaws.com/oman_visa/123456789/A123456/oman_visa_RcllxMT"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Application Number

Authentication Error

Missing Parameters

{
    "status_code": 400,
    "success": false,
    "message": "Invalid application number provided",
    "message_code": "invalid_application_number"
}

The application number provided does not match any records in the system.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Validate and sanitize all user inputs before sending to the API

Use HTTPS for all API communications

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Provide clear feedback to users about the visa verification status

Implement loading indicators during API calls to improve perceived performance

Cache verification results when appropriate to reduce redundant API calls

Offer options to download or view the visa application PDF directly

Display friendly error messages that guide users toward resolution

Code Samples

cURL

Python

Node.js

Related APIs

Passport Verification API - Verify passport details against government records

Visa Application Status API - Check status of visa applications for multiple countries

Document Verification API - Verify the authenticity of travel and identity documents

Compliance and Legal Considerations

This API handles personal identification information that may be subject to data protection regulations. Ensure your use of this API complies with relevant privacy laws including GDPR if applicable. The visa verification should only be performed with the explicit consent of the visa applicant or their authorized representative. Data retrieved through this API should be handled securely and retained only as long as necessary for the verification purpose.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/oman/visa-verification' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "application_number": "123456789", "document_number": "A1234567", "country": "india" }'

{ "data": { "client_id": "oman_visa_RcllxMTkOaivvhrUybxC", "application_number": "123456789", "document_number": "A123456", "country": "india", "status": "Approved", "application_pdf": "https://aadhaar-kyc-docs.s3.amazonaws.com/oman_visa/123456789/A123456/oman_visa_RcllxMT" }, "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 ********************

Oman Visa

Oman 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