Visa Search & Pricing API
Look up the visas you can file, with prices in INR, processing times, entry type, validity and the documents each traveller must provide. Use the quote endpoint to preview the total for a group before you create an application. All prices are per traveller.
Base URL https://api.vismora.com
List visas
GET
/api/visas
Returns the visas you can file, newest first. Pass travelStartDate to find out whether each visa can be processed in time for the trip: if not, canProcessInTime is false and readyDate shows the earliest date it could be ready.
Parameters
| Name | In | Description |
|---|---|---|
country
optional
string
|
query |
Destination country: its _id, its exact code (e.g. AE), or part of its name (e.g. emir).
|
type
optional
string
|
query |
Only return visas of this purpose.
One of:
Tourist Business |
travelStartDate
optional
string (date)
|
query |
Planned travel date (YYYY-MM-DD), used to compute canProcessInTime.
|
travelEndDate
optional
string (date)
|
query |
Planned return date (YYYY-MM-DD). Echoed back in filters.
|
page
optional
integer
|
query |
Page number, starting at 1.
Default:
1 |
limit
optional
integer
|
query |
Items per page. Maximum 100.
Default:
20 |
Response fields
| Field | Type | Description |
|---|---|---|
success
|
boolean | |
visas
|
array of objects | |
visas[]._id
|
string |
Visa ID. Use it as visaId when creating an application.
|
visas[].name
|
string | Display name. |
visas[].purpose
|
string |
e.g. Tourist, Business.
|
visas[].description
|
string | |
visas[].price
|
number | Base price per traveller in INR. |
visas[].category
|
string |
e.g. e-Visa, Sticker.
|
visas[].processingTimeInDays
|
integer | Processing time in business days. |
visas[].requiredProcurementDays
|
integer | Business days needed end to end, including document collection. |
visas[].duration
|
string |
Permitted stay, e.g. 30 Days.
|
visas[].entry
|
string |
Single or Multiple.
|
visas[].validityInDays
|
integer | Days the visa stays valid from issue. |
visas[].notes
|
string | |
visas[].country
|
object | |
visas[].country._id
|
string | |
visas[].country.name
|
string | |
visas[].country.code
|
string |
ISO 3166-1 alpha-2 code, e.g. AE.
|
visas[].requiredDocuments
|
array of objects | |
visas[].requiredDocuments[].name
|
string |
Document name. Send this exact value as documentType when uploading.
|
visas[].requiredDocuments[].description
|
string | What the document must show. |
visas[].requiredDocuments[].mandatory
|
boolean | Whether every traveller must provide it. |
visas[].variations
|
array of objects | |
visas[].variations[].name
|
string |
Send this as a traveller's visaType to use this price.
|
visas[].variations[].price
|
number | Price per traveller in INR. |
visas[].variations[].description
|
string | |
visas[].variations[].ageBracket
|
string | Age range the variation applies to, when set. |
visas[].variations[].relation
|
string | Relationship to the primary applicant the variation applies to, when set. |
visas[].visaByDate
|
string (date-time) | Estimated date the visa would be ready if you apply today. |
visas[].visaByDateFormatted
|
string |
visaByDate formatted for display (IST).
|
visas[].canProcessInTime
|
boolean |
List endpoint only. Whether the visa can be ready by travelStartDate. Always true when no travel date is given.
|
visas[].readyDate
|
string (date) |
List endpoint only, when canProcessInTime is false: earliest ready date.
|
visas[].requiredProcessingDays
|
integer |
List endpoint only, when canProcessInTime is false.
|
pagination
|
object | |
pagination.page
|
integer | Current page. |
pagination.limit
|
integer | Items per page. |
pagination.total
|
integer | Total matching items. |
pagination.pages
|
integer | Total pages. |
filters
|
object | The filters that were applied. |
filters.country
|
string | |
filters.travelStartDate
|
string | |
filters.travelEndDate
|
string | |
filters.type
|
string |
Responses
| Status | Meaning |
|---|---|
| 200 | A page of visas. |
| 401 | The token is missing, invalid or expired. Log in again. |
| 403 | The account was disabled, unapproved or had API access turned off after the token was issued. |
| 429 | Rate limit reached. Wait for the number of seconds in the Retry-After header, then retry. |
| 500 | Something went wrong on our side. Retry later, and contact support if it continues. |
Request
curl -X GET "https://api.vismora.com/api/visas" \
-H "Authorization: Bearer $VISMORA_TOKEN"
Response 200
{
"success": true,
"visas": [
{
"_id": "6650a1f2c3d4e5f6a7b8c9d0",
"name": "UAE 30 Days Tourist e-Visa",
"purpose": "Tourist",
"description": "30 days single entry tourist e-visa",
"price": 7500,
"category": "e-Visa",
"processingTimeInDays": 4,
"requiredProcurementDays": 5,
"duration": "30 Days",
"entry": "Single",
"validityInDays": 58,
"notes": "Processing time excludes UAE public holidays.",
"country": {
"_id": "664a0b1c2d3e4f5a6b7c8d9e",
"name": "United Arab Emirates",
"code": "AE"
},
"requiredDocuments": [
{
"name": "Passport Front",
"description": "Colour scan of the passport bio page",
"mandatory": true
},
{
"name": "Photograph",
"description": "White background, recent",
"mandatory": true
},
{
"name": "Return Ticket",
"description": "Confirmed or on-hold return booking",
"mandatory": false
}
],
"variations": [
{
"name": "child",
"price": 6000,
"description": "Travellers under 12"
}
],
"visaByDate": "2026-11-27T00:00:00.000Z",
"visaByDateFormatted": "27 Nov 2026",
"canProcessInTime": true
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"pages": 1
},
"filters": {
"country": "AE",
"travelStartDate": "2026-12-20",
"travelEndDate": null,
"type": "Tourist"
}
}
Response 401
{
"success": false,
"error": "Invalid or expired token. Please login again."
}
Get a visa
GET
/api/visas/{id}
Returns one visa with its full list of required documents and variations. Use requiredDocuments[].name as the documentType when you upload documents.
Parameters
| Name | In | Description |
|---|---|---|
id
required
string
|
path |
Visa _id (24 hex characters).
|
Response fields
| Field | Type | Description |
|---|---|---|
success
|
boolean | |
visa
|
object | |
visa._id
|
string |
Visa ID. Use it as visaId when creating an application.
|
visa.name
|
string | Display name. |
visa.purpose
|
string |
e.g. Tourist, Business.
|
visa.description
|
string | |
visa.price
|
number | Base price per traveller in INR. |
visa.category
|
string |
e.g. e-Visa, Sticker.
|
visa.processingTimeInDays
|
integer | Processing time in business days. |
visa.requiredProcurementDays
|
integer | Business days needed end to end, including document collection. |
visa.duration
|
string |
Permitted stay, e.g. 30 Days.
|
visa.entry
|
string |
Single or Multiple.
|
visa.validityInDays
|
integer | Days the visa stays valid from issue. |
visa.notes
|
string | |
visa.country
|
object | |
visa.country._id
|
string | |
visa.country.name
|
string | |
visa.country.code
|
string |
ISO 3166-1 alpha-2 code, e.g. AE.
|
visa.requiredDocuments
|
array of objects | |
visa.requiredDocuments[].name
|
string |
Document name. Send this exact value as documentType when uploading.
|
visa.requiredDocuments[].description
|
string | What the document must show. |
visa.requiredDocuments[].mandatory
|
boolean | Whether every traveller must provide it. |
visa.variations
|
array of objects | |
visa.variations[].name
|
string |
Send this as a traveller's visaType to use this price.
|
visa.variations[].price
|
number | Price per traveller in INR. |
visa.variations[].description
|
string | |
visa.variations[].ageBracket
|
string | Age range the variation applies to, when set. |
visa.variations[].relation
|
string | Relationship to the primary applicant the variation applies to, when set. |
visa.visaByDate
|
string (date-time) | Estimated date the visa would be ready if you apply today. |
visa.visaByDateFormatted
|
string |
visaByDate formatted for display (IST).
|
visa.canProcessInTime
|
boolean |
List endpoint only. Whether the visa can be ready by travelStartDate. Always true when no travel date is given.
|
visa.readyDate
|
string (date) |
List endpoint only, when canProcessInTime is false: earliest ready date.
|
visa.requiredProcessingDays
|
integer |
List endpoint only, when canProcessInTime is false.
|
Responses
| Status | Meaning |
|---|---|
| 200 | The visa. |
| 401 | The token is missing, invalid or expired. Log in again. |
| 403 | The account was disabled, unapproved or had API access turned off after the token was issued. |
| 404 | The visa doesn't exist or is no longer offered. |
| 429 | Rate limit reached. Wait for the number of seconds in the Retry-After header, then retry. |
| 500 | Something went wrong on our side. Retry later, and contact support if it continues. |
Request
curl -X GET "https://api.vismora.com/api/visas/6650a1f2c3d4e5f6a7b8c9d0" \
-H "Authorization: Bearer $VISMORA_TOKEN"
Response 200
{
"success": true,
"visa": {
"_id": "6650a1f2c3d4e5f6a7b8c9d0",
"name": "UAE 30 Days Tourist e-Visa",
"purpose": "Tourist",
"description": "30 days single entry tourist e-visa",
"price": 7500,
"category": "e-Visa",
"processingTimeInDays": 4,
"requiredProcurementDays": 5,
"duration": "30 Days",
"entry": "Single",
"validityInDays": 58,
"country": {
"_id": "664a0b1c2d3e4f5a6b7c8d9e",
"name": "United Arab Emirates",
"code": "AE"
},
"requiredDocuments": [
{
"name": "Passport Front",
"description": "Colour scan of the passport bio page",
"mandatory": true
},
{
"name": "Photograph",
"description": "White background, recent",
"mandatory": true
}
],
"variations": [
{
"name": "child",
"price": 6000,
"description": "Travellers under 12"
}
],
"visaByDate": "2026-11-28T00:00:00.000Z",
"visaByDateFormatted": "28 Nov 2026"
}
}
Response 401
{
"success": false,
"error": "Invalid or expired token. Please login again."
}
Get a price quote
GET
/api/visas/{id}/quote
Previews the total for a group of travellers without creating anything. The first traveller is charged the base price; use visaTypes to price the others as a variation. A coupon that isn't valid is ignored rather than rejected, so check discountApplied.
Parameters
| Name | In | Description |
|---|---|---|
id
required
string
|
path |
Visa _id (24 hex characters).
|
passengers
required
integer
|
query | Number of travellers. |
visaTypes
optional
string
|
query |
Comma-separated variation names for travellers 2 to N, in order (the first value applies to traveller 2). Use primary for the base price.
|
couponCode
optional
string
|
query | Coupon to apply. |
useViscoins
optional
string
|
query |
Set to 1 to redeem Viscoins (loyalty points). Can't be combined with a coupon.
One of:
1 |
Response fields
| Field | Type | Description |
|---|---|---|
success
|
boolean | |
visa
|
object | |
visa._id
|
string | |
visa.name
|
string | |
visa.purpose
|
string | |
visa.price
|
number | |
visa.country
|
object | |
visa.country._id
|
string | |
visa.country.name
|
string | |
visa.country.code
|
string |
ISO 3166-1 alpha-2 code, e.g. AE.
|
pricing
|
object | Price breakdown. Prices are per traveller and already summed. |
pricing.visaPrice
|
number | Base visa price per traveller in INR. |
pricing.passengerCount
|
integer | |
pricing.subtotal
|
number | Sum of traveller prices before discount. |
pricing.discountApplied
|
number | Coupon or Viscoins discount. |
pricing.convenienceFee
|
number | |
pricing.totalAmount
|
number | Amount payable: subtotal − discount + convenience fee. Do not multiply by passenger count. |
pricing.passengers
|
array of objects | |
pricing.passengers[].index
|
integer |
Position in visaSeekers.
|
pricing.passengers[].visaType
|
string | |
pricing.passengers[].price
|
number | |
pricing.note
|
string |
Responses
| Status | Meaning |
|---|---|
| 200 | The quote. |
| 400 | passengers is missing or less than 1. |
| 401 | The token is missing, invalid or expired. Log in again. |
| 403 | The account was disabled, unapproved or had API access turned off after the token was issued. |
| 404 | The visa doesn't exist or is no longer offered. |
| 429 | Rate limit reached. Wait for the number of seconds in the Retry-After header, then retry. |
| 500 | Something went wrong on our side. Retry later, and contact support if it continues. |
Request
curl -X GET "https://api.vismora.com/api/visas/6650a1f2c3d4e5f6a7b8c9d0/quote?passengers=2" \
-H "Authorization: Bearer $VISMORA_TOKEN"
Response 200
{
"success": true,
"visa": {
"_id": "6650a1f2c3d4e5f6a7b8c9d0",
"name": "UAE 30 Days Tourist e-Visa",
"purpose": "Tourist",
"price": 7500,
"country": {
"_id": "664a0b1c2d3e4f5a6b7c8d9e",
"name": "United Arab Emirates",
"code": "AE"
}
},
"pricing": {
"visaPrice": 7500,
"passengerCount": 3,
"subtotal": 21000,
"discountApplied": 0,
"convenienceFee": 0,
"totalAmount": 21000,
"passengers": [
{
"index": 0,
"visaType": "primary",
"price": 7500
},
{
"index": 1,
"visaType": "child",
"price": 6000
},
{
"index": 2,
"visaType": "primary",
"price": 7500
}
],
"note": "Visa price is per passenger. totalAmount already equals the sum of passenger prices minus discount plus convenience fee — do not multiply by passenger count again."
}
}
Response 400
{
"success": false,
"error": "Query parameter \"passengers\" is required and must be at least 1"
}
List countries for visa filters
GET
/api/visas/countries/list
All active destination countries with just their name and code, sorted by name. Handy for a country picker in front of the visa list.
Response fields
| Field | Type | Description |
|---|---|---|
success
|
boolean | |
countries
|
array of objects | |
countries[]._id
|
string | |
countries[].name
|
string | |
countries[].code
|
string |
ISO 3166-1 alpha-2 code, e.g. AE.
|
Responses
| Status | Meaning |
|---|---|
| 200 | Countries. |
| 401 | The token is missing, invalid or expired. Log in again. |
| 403 | The account was disabled, unapproved or had API access turned off after the token was issued. |
| 429 | Rate limit reached. Wait for the number of seconds in the Retry-After header, then retry. |
| 500 | Something went wrong on our side. Retry later, and contact support if it continues. |
Request
curl -X GET "https://api.vismora.com/api/visas/countries/list" \
-H "Authorization: Bearer $VISMORA_TOKEN"
Response 200
{
"success": true,
"countries": [
{
"_id": "664a0b1c2d3e4f5a6b7c8d9e",
"name": "United Arab Emirates",
"code": "AE"
},
{
"_id": "664a0b1c2d3e4f5a6b7c8d9f",
"name": "Vietnam",
"code": "VN"
}
]
}
Response 401
{
"success": false,
"error": "Invalid or expired token. Please login again."
}