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
- Create a partner account. Sign up as a travel agent and complete your company details.
- Request API access. Tell us about your integration on the API integration page. Our team reviews every request.
- Log in with your account. Once approved, use the same email and password with
POST /api/auth/loginto get a token. - Top up your wallet. Applications are paid from your prepaid Vismora wallet, debited when processing starts.
Basics
| Base URL | https://api.vismora.com |
|---|---|
| Format | JSON requests and responses (Content-Type: application/json). The invoice endpoint returns HTML. |
| Authentication | Bearer token in the Authorization header. Tokens last 7 days. Details |
| Amounts | Indian rupees (INR). Visa prices are per traveller. |
| Dates | Send dates as YYYY-MM-DD. Timestamps are returned in ISO 8601 UTC, e.g. 2026-12-02T09:15:00.000Z. |
| IDs | Resources are identified by a 24-character hexadecimal _id. |
| Pagination | List 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"
}
]
}
| Status | Meaning |
|---|---|
| 200 | Success. |
| 201 | Application created. |
| 400 | The request is invalid. Fix it before retrying. |
| 401 | Missing, invalid or expired token, or wrong login details. Log in again. |
| 403 | Your account can't use the API right now: it's disabled, not yet approved, or API access isn't enabled. |
| 404 | Not found, or it doesn't belong to your account. |
| 429 | Rate limit reached. Wait for the Retry-After seconds, then retry. |
| 500 | Something 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.
| What | Limit | Counted per |
|---|---|---|
| All API requests | 120 per minute | Partner account (IP address before login) |
| Creating applications | 30 per minute | Partner account |
| Failed logins | 10 per 15 minutes | IP 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
pending | submitted, waiting to be picked up. |
assigned | assigned for processing. |
in-progress | being processed (your wallet is debited at this stage). |
query_raised | we need more information from you. |
query_answered | you have responded to a query. |
completed | all travellers have a final outcome. |
hold | paused. |
cancelled | cancelled. |
Traveller status
pending | not started. |
WIP | being processed. |
approved | visa issued. |
disapproved | visa 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