API Docs

Vismora Partner API · v1.0.0

Visa API documentation

A REST API for travel agents, OTAs and travel-tech platforms. Search visas and prices, file visa applications with traveller documents, track every traveller's status, download the issued visa and the GST invoice, and check your wallet, all from your own system.

API reference

Getting access

  1. Create a partner account. Sign up as a travel agent and complete your company details.
  2. Request API access. Tell us about your integration on the API integration page. Our team reviews every request.
  3. Log in with your account. Once approved, use the same email and password with POST /api/auth/login to get a token.
  4. Top up your wallet. Applications are paid from your prepaid Vismora wallet, debited when processing starts.

Basics

Base URLhttps://api.vismora.com
FormatJSON requests and responses (Content-Type: application/json). The invoice endpoint returns HTML.
AuthenticationBearer token in the Authorization header. Tokens last 7 days. Details
AmountsIndian rupees (INR). Visa prices are per traveller.
DatesSend dates as YYYY-MM-DD. Timestamps are returned in ISO 8601 UTC, e.g. 2026-12-02T09:15:00.000Z.
IDsResources are identified by a 24-character hexadecimal _id.
PaginationList endpoints take page and limit and return a pagination object with page, limit, total and pages.

Quickstart

File your first visa application in four calls.

1. Log in

curl -X POST "https://api.vismora.com/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email": "partner@yourcompany.com", "password": "your-password"}'

Save the token from the response and send it on every other request.

2. Find a visa and its required documents

curl "https://api.vismora.com/api/visas?country=AE&type=Tourist&travelStartDate=2026-12-20" \
  -H "Authorization: Bearer $VISMORA_TOKEN"

Note the visa's _id and the name of each document in requiredDocuments where mandatory is true. Optionally preview the price for your group with the quote endpoint.

3. Create the application

curl -X POST "https://api.vismora.com/api/applications" \
  -H "Authorization: Bearer $VISMORA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "visaId": "6650a1f2c3d4e5f6a7b8c9d0",
    "travelStartDate": "2026-12-20",
    "visaSeekers": [{
      "firstName": "Aarav",
      "lastName": "Mehta",
      "category": "Adult",
      "documents": [
        { "documentType": "Passport Front", "fileName": "passport.jpg", "fileData": "<base64>" },
        { "documentType": "Photograph", "fileName": "photo.jpg", "fileData": "<base64>" }
      ]
    }]
  }'

The response contains the application _id and its reference, e.g. AE-AGB2C3-001.

4. Track it

curl "https://api.vismora.com/api/applications/6661b2c3d4e5f6a7b8c9d0e1/status" \
  -H "Authorization: Bearer $VISMORA_TOKEN"

When a traveller is approved, the response includes a download link for their visa.

Errors

Every response has a success flag. Errors use standard HTTP status codes and one of two bodies.

Most errors

{
  "success": false,
  "error": "Application not found"
}

Field validation (400)

{
  "success": false,
  "errors": [
    {
      "msg": "First name is required",
      "path": "visaSeekers[0].firstName",
      "location": "body"
    }
  ]
}
StatusMeaning
200Success.
201Application created.
400The request is invalid. Fix it before retrying.
401Missing, invalid or expired token, or wrong login details. Log in again.
403Your account can't use the API right now: it's disabled, not yet approved, or API access isn't enabled.
404Not found, or it doesn't belong to your account.
429Rate limit reached. Wait for the Retry-After seconds, then retry.
500Something went wrong on our side. Retry with backoff, and contact support if it continues.

Rate limits

Limits protect the platform for every partner. Each response carries a RateLimit header such as limit=120, remaining=87, reset=42, where reset is the number of seconds until the window resets. Over the limit, you get 429 with a Retry-After header.

WhatLimitCounted per
All API requests120 per minutePartner account (IP address before login)
Creating applications30 per minutePartner account
Failed logins10 per 15 minutesIP address

Reuse your token for its full 7 days instead of logging in on every request, and cache visa and country data, which changes rarely. If your volume needs higher limits, contact us.

Statuses

An application has one overall status, and each traveller in it has their own.

Application status

pendingsubmitted, waiting to be picked up.
assignedassigned for processing.
in-progressbeing processed (your wallet is debited at this stage).
query_raisedwe need more information from you.
query_answeredyou have responded to a query.
completedall travellers have a final outcome.
holdpaused.
cancelledcancelled.

Traveller status

pendingnot started.
WIPbeing processed.
approvedvisa issued.
disapprovedvisa refused.

Security

  • All traffic uses HTTPS. Keep your password and tokens on your server, never in a browser or mobile app.
  • Responses never include stored file locations. Issued visas are shared through temporary download links.
  • You only ever see applications and wallet entries that belong to your own account.

Ready to integrate?

Request API access and our team will review your request and get in touch.

Request API access