API Docs

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

NameInDescription
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

FieldTypeDescription
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

StatusMeaning
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

NameInDescription
id required
string
path Visa _id (24 hex characters).

Response fields

FieldTypeDescription
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

StatusMeaning
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

NameInDescription
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

FieldTypeDescription
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

StatusMeaning
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

FieldTypeDescription
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

StatusMeaning
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."
}