API Docs

Visa Applications API

Create a visa application for one or more travellers, upload their documents as base64, and track the application through to approval. The first traveller in visaSeekers is always the primary applicant and is charged the visa's base price. Additional travellers pay the base price or the price of the variation named in their visaType.

Base URL https://api.vismora.com

Create an application

POST /api/applications

Creates a visa application for one or more travellers. Every traveller must include each document the visa marks as mandatory, matched by documentType = the document's name. A document type that accepts several files can be sent as several entries with the same documentType. Each file can be up to 10 MB after base64 decoding. The new application starts in pending status. This endpoint has its own, tighter rate limit.

Request body

FieldTypeDescription
visaId required string The visa _id to apply for.
visaSeekers required array of objects Travellers. The first one is the primary applicant.
visaSeekers[].firstName required string As printed on the passport.
visaSeekers[].lastName required string As printed on the passport.
visaSeekers[].category required string
One of: Adult Child
visaSeekers[].passportNumber optional string
visaSeekers[].mobile optional string With country code, e.g. +919800000001.
visaSeekers[].email optional string (email)
visaSeekers[].occupation optional string
visaSeekers[].visaType optional string For travellers after the first: a variation name, or primary for the base price (default). Ignored for the first traveller.
visaSeekers[].documents optional array of objects Documents for this traveller. Must cover every mandatory document of the visa.
visaSeekers[].documents[].documentType required string Must equal a requiredDocuments[].name of the visa.
visaSeekers[].documents[].fileName required string Original file name, including extension.
visaSeekers[].documents[].fileData required string File content as base64. A data:…;base64, prefix is accepted. Up to 10 MB decoded.
visaSeekers[].documents[].mimeType optional string e.g. application/pdf, image/jpeg. Worked out from the file name when omitted.
travelStartDate optional string (date) Planned travel date (YYYY-MM-DD).
travelEndDate optional string (date) Planned return date (YYYY-MM-DD).
couponCode optional string Discount coupon. An invalid coupon is ignored, not rejected.
useViscoins optional boolean Redeem Viscoins (loyalty points) instead of a coupon.

Response fields

FieldTypeDescription
success boolean
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
application object
application._id string Application ID.
application.ref string Human-readable reference, e.g. AE-AGB2C3-001. Quote it when contacting support.
application.status string 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.
One of: pending assigned in-progress query_raised query_answered completed hold cancelled
application.totalAmount number Amount payable in INR, after discount and including the convenience fee.
application.discountApplied number Discount in INR.
application.finalAmount number Same as totalAmount.
application.convenienceFee number
application.couponCode string
application.viscoinsUsed number Viscoins redeemed.
application.notes array of anys Notes added during processing.
application.createdVia string Where the application was created.
One of: api website admin
application.user string Your account ID.
application.country object
application.country._id string
application.country.name string
application.country.code string ISO 3166-1 alpha-2 code, e.g. TH.
application.country.flag string (uri) Flag image URL.
application.country.image string (uri) Destination image URL.
application.country.showOnHomepage boolean Only returned by GET /api/countries/{id}.
application.visaType object
application.visaType._id string Visa ID. Use it as visaId when creating an application.
application.visaType.name string Display name.
application.visaType.purpose string e.g. Tourist, Business.
application.visaType.description string
application.visaType.price number Base price per traveller in INR.
application.visaType.category string e.g. e-Visa, Sticker.
application.visaType.processingTimeInDays integer Processing time in business days.
application.visaType.requiredProcurementDays integer Business days needed end to end, including document collection.
application.visaType.duration string Permitted stay, e.g. 30 Days.
application.visaType.entry string Single or Multiple.
application.visaType.validityInDays integer Days the visa stays valid from issue.
application.visaType.notes string
application.visaType.country object
application.visaType.country._id string
application.visaType.country.name string
application.visaType.country.code string ISO 3166-1 alpha-2 code, e.g. AE.
application.visaType.requiredDocuments array of objects
application.visaType.requiredDocuments[].name string Document name. Send this exact value as documentType when uploading.
application.visaType.requiredDocuments[].description string What the document must show.
application.visaType.requiredDocuments[].mandatory boolean Whether every traveller must provide it.
application.visaType.variations array of objects
application.visaType.variations[].name string Send this as a traveller's visaType to use this price.
application.visaType.variations[].price number Price per traveller in INR.
application.visaType.variations[].description string
application.visaType.variations[].ageBracket string Age range the variation applies to, when set.
application.visaType.variations[].relation string Relationship to the primary applicant the variation applies to, when set.
application.visaType.visaByDate string (date-time) Estimated date the visa would be ready if you apply today.
application.visaType.visaByDateFormatted string visaByDate formatted for display (IST).
application.visaType.canProcessInTime boolean List endpoint only. Whether the visa can be ready by travelStartDate. Always true when no travel date is given.
application.visaType.readyDate string (date) List endpoint only, when canProcessInTime is false: earliest ready date.
application.visaType.requiredProcessingDays integer List endpoint only, when canProcessInTime is false.
application.visaSeekers array of objects
application.visaSeekers[]._id string
application.visaSeekers[].firstName string
application.visaSeekers[].lastName string
application.visaSeekers[].passportNumber string
application.visaSeekers[].category string
One of: Adult Child
application.visaSeekers[].mobile string
application.visaSeekers[].email string
application.visaSeekers[].occupation string
application.visaSeekers[].isPrimary boolean true for the first traveller.
application.visaSeekers[].visaType string primary or a variation name.
application.visaSeekers[].price number Price for this traveller in INR.
application.visaSeekers[].status string pending: not started. WIP: being processed. approved: visa issued. disapproved: visa refused.
One of: pending WIP approved disapproved
application.visaSeekers[].documents array of objects Uploaded documents. File locations are never exposed.
application.visaSeekers[].documents[].documentType string
application.visaSeekers[].documents[].fileName string
application.visaSeekers[].approvalDoc object Present only once the document has been issued.
application.visaSeekers[].approvalDoc.available boolean
application.visaSeekers[].approvalDoc.fileName string
application.visaSeekers[].approvalDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
application.visaSeekers[].approvalDoc.expiresInMinutes integer
application.visaSeekers[].rejectionDoc object Present only once the document has been issued.
application.visaSeekers[].rejectionDoc.available boolean
application.visaSeekers[].rejectionDoc.fileName string
application.visaSeekers[].rejectionDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
application.visaSeekers[].rejectionDoc.expiresInMinutes integer
application.additionalCharges array of objects Extra charges added during processing.
application.additionalCharges[].description string
application.additionalCharges[].amount number
application.additionalCharges[].addedAt string (date-time)
application.invoiceCalculations object Invoice breakdown in INR, once the application is being processed.
application.invoiceCalculations.priceTotal number
application.invoiceCalculations.totalDiscount number
application.invoiceCalculations.taxableAmountIncludingGST number
application.invoiceCalculations.visaPriceTotal number
application.invoiceCalculations.additionalChargesNetTotal number
application.invoiceCalculations.totalGST number
application.invoiceCalculations.cgst number
application.invoiceCalculations.sgst number
application.invoiceCalculations.igst number
application.invoiceCalculations.serviceChargeAmount number
application.invoiceCalculations.netTotal number
application.invoiceCalculations.grossTotal number
application.invoiceCalculations.calculatedAt string (date-time)
application.travelDate string (date-time)
application.returnDate string (date-time)
application.purpose string

Responses

StatusMeaning
201 Application created.
400 The request failed validation: a missing or invalid field, a missing mandatory document, or an unknown traveller pricing. Field-level problems come back as an errors array; other problems as a single error message.
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 The application couldn't be created, for example because a document upload failed. Nothing is saved in that case, so it is safe to retry.

Request

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

Full request body

{
  "visaId": "6650a1f2c3d4e5f6a7b8c9d0",
  "travelStartDate": "2026-12-20",
  "travelEndDate": "2026-12-28",
  "visaSeekers": [
    {
      "firstName": "Aarav",
      "lastName": "Mehta",
      "category": "Adult",
      "passportNumber": "Z1234567",
      "mobile": "+919800000001",
      "email": "aarav@example.com",
      "occupation": "Engineer",
      "documents": [
        {
          "documentType": "Passport Front",
          "fileName": "passport-front.jpg",
          "mimeType": "image/jpeg",
          "fileData": "/9j/4AAQSkZJRgABAQ..."
        },
        {
          "documentType": "Photograph",
          "fileName": "photo.jpg",
          "mimeType": "image/jpeg",
          "fileData": "/9j/4AAQSkZJRgABAQ..."
        }
      ]
    },
    {
      "firstName": "Anaya",
      "lastName": "Mehta",
      "category": "Child",
      "visaType": "child",
      "documents": [
        {
          "documentType": "Passport Front",
          "fileName": "anaya-passport.pdf",
          "mimeType": "application/pdf",
          "fileData": "JVBERi0xLjQKJ..."
        },
        {
          "documentType": "Photograph",
          "fileName": "anaya-photo.jpg",
          "mimeType": "image/jpeg",
          "fileData": "/9j/4AAQSkZJRgABAQ..."
        }
      ]
    }
  ],
  "couponCode": "WINTER10"
}

Response 201

{
  "success": true,
  "pricing": {
    "visaPrice": 7500,
    "passengerCount": 2,
    "subtotal": 13500,
    "discountApplied": 1350,
    "convenienceFee": 0,
    "totalAmount": 12150,
    "passengers": [
      {
        "index": 0,
        "visaType": "primary",
        "price": 7500
      },
      {
        "index": 1,
        "visaType": "child",
        "price": 6000
      }
    ],
    "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."
  },
  "application": {
    "_id": "6661b2c3d4e5f6a7b8c9d0e1",
    "ref": "AE-AGB2C3-001",
    "status": "pending",
    "totalAmount": 12150,
    "discountApplied": 1350,
    "finalAmount": 12150,
    "convenienceFee": 0,
    "couponCode": "WINTER10",
    "viscoinsUsed": 0,
    "notes": [],
    "createdVia": "api",
    "user": "665f1c2ab4e9a3d1f0a1b2c3",
    "country": {
      "_id": "664a0b1c2d3e4f5a6b7c8d9e",
      "name": "United Arab Emirates",
      "code": "AE",
      "flag": "https://flagcdn.com/w80/ae.png"
    },
    "visaType": {
      "_id": "6650a1f2c3d4e5f6a7b8c9d0",
      "purpose": "Tourist",
      "description": "30 days single entry tourist e-visa",
      "price": 7500,
      "category": "e-Visa",
      "processingTimeInDays": 4,
      "duration": "30 Days",
      "entry": "Single",
      "validityInDays": 58,
      "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"
        }
      ]
    },
    "visaSeekers": [
      {
        "_id": "6661b2c3d4e5f6a7b8c9d0e2",
        "firstName": "Aarav",
        "lastName": "Mehta",
        "passportNumber": "Z1234567",
        "category": "Adult",
        "mobile": "+919800000001",
        "email": "aarav@example.com",
        "occupation": "Engineer",
        "isPrimary": true,
        "visaType": "primary",
        "price": 7500,
        "status": "pending",
        "documents": [
          {
            "documentType": "Passport Front",
            "fileName": "passport-front.jpg"
          },
          {
            "documentType": "Photograph",
            "fileName": "photo.jpg"
          }
        ]
      },
      {
        "_id": "6661b2c3d4e5f6a7b8c9d0e3",
        "firstName": "Anaya",
        "lastName": "Mehta",
        "category": "Child",
        "email": "",
        "occupation": "",
        "isPrimary": false,
        "visaType": "child",
        "price": 6000,
        "status": "pending",
        "documents": [
          {
            "documentType": "Passport Front",
            "fileName": "anaya-passport.pdf"
          },
          {
            "documentType": "Photograph",
            "fileName": "anaya-photo.jpg"
          }
        ]
      }
    ]
  }
}

Response 400

{
  "success": false,
  "error": "Missing required documents for visa seeker 2: Photograph"
}

List applications

GET /api/applications

Returns your applications, newest first. In the list view visaType only contains _id, purpose and price; fetch a single application for full details.

Parameters

NameInDescription
page optional
integer
query Page number, starting at 1.
Default: 1
limit optional
integer
query Items per page. Maximum 100.
Default: 20
status optional
string
query Only return applications in this status.
One of: pending assigned in-progress query_raised query_answered completed hold cancelled

Response fields

FieldTypeDescription
success boolean
applications array of objects
applications[]._id string Application ID.
applications[].ref string Human-readable reference, e.g. AE-AGB2C3-001. Quote it when contacting support.
applications[].status string 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.
One of: pending assigned in-progress query_raised query_answered completed hold cancelled
applications[].totalAmount number Amount payable in INR, after discount and including the convenience fee.
applications[].discountApplied number Discount in INR.
applications[].finalAmount number Same as totalAmount.
applications[].convenienceFee number
applications[].couponCode string
applications[].viscoinsUsed number Viscoins redeemed.
applications[].notes array of anys Notes added during processing.
applications[].createdVia string Where the application was created.
One of: api website admin
applications[].user string Your account ID.
applications[].country object
applications[].country._id string
applications[].country.name string
applications[].country.code string ISO 3166-1 alpha-2 code, e.g. TH.
applications[].country.flag string (uri) Flag image URL.
applications[].country.image string (uri) Destination image URL.
applications[].country.showOnHomepage boolean Only returned by GET /api/countries/{id}.
applications[].visaType object
applications[].visaType._id string Visa ID. Use it as visaId when creating an application.
applications[].visaType.name string Display name.
applications[].visaType.purpose string e.g. Tourist, Business.
applications[].visaType.description string
applications[].visaType.price number Base price per traveller in INR.
applications[].visaType.category string e.g. e-Visa, Sticker.
applications[].visaType.processingTimeInDays integer Processing time in business days.
applications[].visaType.requiredProcurementDays integer Business days needed end to end, including document collection.
applications[].visaType.duration string Permitted stay, e.g. 30 Days.
applications[].visaType.entry string Single or Multiple.
applications[].visaType.validityInDays integer Days the visa stays valid from issue.
applications[].visaType.notes string
applications[].visaType.country object
applications[].visaType.country._id string
applications[].visaType.country.name string
applications[].visaType.country.code string ISO 3166-1 alpha-2 code, e.g. AE.
applications[].visaType.requiredDocuments array of objects
applications[].visaType.requiredDocuments[].name string Document name. Send this exact value as documentType when uploading.
applications[].visaType.requiredDocuments[].description string What the document must show.
applications[].visaType.requiredDocuments[].mandatory boolean Whether every traveller must provide it.
applications[].visaType.variations array of objects
applications[].visaType.variations[].name string Send this as a traveller's visaType to use this price.
applications[].visaType.variations[].price number Price per traveller in INR.
applications[].visaType.variations[].description string
applications[].visaType.variations[].ageBracket string Age range the variation applies to, when set.
applications[].visaType.variations[].relation string Relationship to the primary applicant the variation applies to, when set.
applications[].visaType.visaByDate string (date-time) Estimated date the visa would be ready if you apply today.
applications[].visaType.visaByDateFormatted string visaByDate formatted for display (IST).
applications[].visaType.canProcessInTime boolean List endpoint only. Whether the visa can be ready by travelStartDate. Always true when no travel date is given.
applications[].visaType.readyDate string (date) List endpoint only, when canProcessInTime is false: earliest ready date.
applications[].visaType.requiredProcessingDays integer List endpoint only, when canProcessInTime is false.
applications[].visaSeekers array of objects
applications[].visaSeekers[]._id string
applications[].visaSeekers[].firstName string
applications[].visaSeekers[].lastName string
applications[].visaSeekers[].passportNumber string
applications[].visaSeekers[].category string
One of: Adult Child
applications[].visaSeekers[].mobile string
applications[].visaSeekers[].email string
applications[].visaSeekers[].occupation string
applications[].visaSeekers[].isPrimary boolean true for the first traveller.
applications[].visaSeekers[].visaType string primary or a variation name.
applications[].visaSeekers[].price number Price for this traveller in INR.
applications[].visaSeekers[].status string pending: not started. WIP: being processed. approved: visa issued. disapproved: visa refused.
One of: pending WIP approved disapproved
applications[].visaSeekers[].documents array of objects Uploaded documents. File locations are never exposed.
applications[].visaSeekers[].documents[].documentType string
applications[].visaSeekers[].documents[].fileName string
applications[].visaSeekers[].approvalDoc object Present only once the document has been issued.
applications[].visaSeekers[].approvalDoc.available boolean
applications[].visaSeekers[].approvalDoc.fileName string
applications[].visaSeekers[].approvalDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
applications[].visaSeekers[].approvalDoc.expiresInMinutes integer
applications[].visaSeekers[].rejectionDoc object Present only once the document has been issued.
applications[].visaSeekers[].rejectionDoc.available boolean
applications[].visaSeekers[].rejectionDoc.fileName string
applications[].visaSeekers[].rejectionDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
applications[].visaSeekers[].rejectionDoc.expiresInMinutes integer
applications[].additionalCharges array of objects Extra charges added during processing.
applications[].additionalCharges[].description string
applications[].additionalCharges[].amount number
applications[].additionalCharges[].addedAt string (date-time)
applications[].invoiceCalculations object Invoice breakdown in INR, once the application is being processed.
applications[].invoiceCalculations.priceTotal number
applications[].invoiceCalculations.totalDiscount number
applications[].invoiceCalculations.taxableAmountIncludingGST number
applications[].invoiceCalculations.visaPriceTotal number
applications[].invoiceCalculations.additionalChargesNetTotal number
applications[].invoiceCalculations.totalGST number
applications[].invoiceCalculations.cgst number
applications[].invoiceCalculations.sgst number
applications[].invoiceCalculations.igst number
applications[].invoiceCalculations.serviceChargeAmount number
applications[].invoiceCalculations.netTotal number
applications[].invoiceCalculations.grossTotal number
applications[].invoiceCalculations.calculatedAt string (date-time)
applications[].travelDate string (date-time)
applications[].returnDate string (date-time)
applications[].purpose string
pagination object
pagination.page integer Current page.
pagination.limit integer Items per page.
pagination.total integer Total matching items.
pagination.pages integer Total pages.

Responses

StatusMeaning
200 A page of applications.
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/applications" \
  -H "Authorization: Bearer $VISMORA_TOKEN"

Response 200

{
  "success": true,
  "applications": [
    {
      "_id": "6661b2c3d4e5f6a7b8c9d0e1",
      "ref": "AE-AGB2C3-001",
      "status": "in-progress",
      "totalAmount": 12150,
      "discountApplied": 1350,
      "finalAmount": 12150,
      "convenienceFee": 0,
      "couponCode": "WINTER10",
      "viscoinsUsed": 0,
      "createdVia": "api",
      "user": "665f1c2ab4e9a3d1f0a1b2c3",
      "country": {
        "_id": "664a0b1c2d3e4f5a6b7c8d9e",
        "name": "United Arab Emirates",
        "code": "AE"
      },
      "visaType": {
        "_id": "6650a1f2c3d4e5f6a7b8c9d0",
        "purpose": "Tourist",
        "price": 7500
      },
      "visaSeekers": [
        {
          "_id": "6661b2c3d4e5f6a7b8c9d0e2",
          "firstName": "Aarav",
          "lastName": "Mehta",
          "category": "Adult",
          "isPrimary": true,
          "visaType": "primary",
          "price": 7500,
          "status": "WIP",
          "documents": []
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "pages": 1
  }
}

Response 401

{
  "success": false,
  "error": "Invalid or expired token. Please login again."
}

Get an application

GET /api/applications/{id}

Returns one of your applications with travellers, documents, pricing, any additional charges and, once the application is being processed, the invoice breakdown. When a traveller's visa is approved or rejected, approvalDoc or rejectionDoc appears with a temporary download link.

Parameters

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

Response fields

FieldTypeDescription
success boolean
application object
application._id string Application ID.
application.ref string Human-readable reference, e.g. AE-AGB2C3-001. Quote it when contacting support.
application.status string 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.
One of: pending assigned in-progress query_raised query_answered completed hold cancelled
application.totalAmount number Amount payable in INR, after discount and including the convenience fee.
application.discountApplied number Discount in INR.
application.finalAmount number Same as totalAmount.
application.convenienceFee number
application.couponCode string
application.viscoinsUsed number Viscoins redeemed.
application.notes array of anys Notes added during processing.
application.createdVia string Where the application was created.
One of: api website admin
application.user string Your account ID.
application.country object
application.country._id string
application.country.name string
application.country.code string ISO 3166-1 alpha-2 code, e.g. TH.
application.country.flag string (uri) Flag image URL.
application.country.image string (uri) Destination image URL.
application.country.showOnHomepage boolean Only returned by GET /api/countries/{id}.
application.visaType object
application.visaType._id string Visa ID. Use it as visaId when creating an application.
application.visaType.name string Display name.
application.visaType.purpose string e.g. Tourist, Business.
application.visaType.description string
application.visaType.price number Base price per traveller in INR.
application.visaType.category string e.g. e-Visa, Sticker.
application.visaType.processingTimeInDays integer Processing time in business days.
application.visaType.requiredProcurementDays integer Business days needed end to end, including document collection.
application.visaType.duration string Permitted stay, e.g. 30 Days.
application.visaType.entry string Single or Multiple.
application.visaType.validityInDays integer Days the visa stays valid from issue.
application.visaType.notes string
application.visaType.country object
application.visaType.country._id string
application.visaType.country.name string
application.visaType.country.code string ISO 3166-1 alpha-2 code, e.g. AE.
application.visaType.requiredDocuments array of objects
application.visaType.requiredDocuments[].name string Document name. Send this exact value as documentType when uploading.
application.visaType.requiredDocuments[].description string What the document must show.
application.visaType.requiredDocuments[].mandatory boolean Whether every traveller must provide it.
application.visaType.variations array of objects
application.visaType.variations[].name string Send this as a traveller's visaType to use this price.
application.visaType.variations[].price number Price per traveller in INR.
application.visaType.variations[].description string
application.visaType.variations[].ageBracket string Age range the variation applies to, when set.
application.visaType.variations[].relation string Relationship to the primary applicant the variation applies to, when set.
application.visaType.visaByDate string (date-time) Estimated date the visa would be ready if you apply today.
application.visaType.visaByDateFormatted string visaByDate formatted for display (IST).
application.visaType.canProcessInTime boolean List endpoint only. Whether the visa can be ready by travelStartDate. Always true when no travel date is given.
application.visaType.readyDate string (date) List endpoint only, when canProcessInTime is false: earliest ready date.
application.visaType.requiredProcessingDays integer List endpoint only, when canProcessInTime is false.
application.visaSeekers array of objects
application.visaSeekers[]._id string
application.visaSeekers[].firstName string
application.visaSeekers[].lastName string
application.visaSeekers[].passportNumber string
application.visaSeekers[].category string
One of: Adult Child
application.visaSeekers[].mobile string
application.visaSeekers[].email string
application.visaSeekers[].occupation string
application.visaSeekers[].isPrimary boolean true for the first traveller.
application.visaSeekers[].visaType string primary or a variation name.
application.visaSeekers[].price number Price for this traveller in INR.
application.visaSeekers[].status string pending: not started. WIP: being processed. approved: visa issued. disapproved: visa refused.
One of: pending WIP approved disapproved
application.visaSeekers[].documents array of objects Uploaded documents. File locations are never exposed.
application.visaSeekers[].documents[].documentType string
application.visaSeekers[].documents[].fileName string
application.visaSeekers[].approvalDoc object Present only once the document has been issued.
application.visaSeekers[].approvalDoc.available boolean
application.visaSeekers[].approvalDoc.fileName string
application.visaSeekers[].approvalDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
application.visaSeekers[].approvalDoc.expiresInMinutes integer
application.visaSeekers[].rejectionDoc object Present only once the document has been issued.
application.visaSeekers[].rejectionDoc.available boolean
application.visaSeekers[].rejectionDoc.fileName string
application.visaSeekers[].rejectionDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
application.visaSeekers[].rejectionDoc.expiresInMinutes integer
application.additionalCharges array of objects Extra charges added during processing.
application.additionalCharges[].description string
application.additionalCharges[].amount number
application.additionalCharges[].addedAt string (date-time)
application.invoiceCalculations object Invoice breakdown in INR, once the application is being processed.
application.invoiceCalculations.priceTotal number
application.invoiceCalculations.totalDiscount number
application.invoiceCalculations.taxableAmountIncludingGST number
application.invoiceCalculations.visaPriceTotal number
application.invoiceCalculations.additionalChargesNetTotal number
application.invoiceCalculations.totalGST number
application.invoiceCalculations.cgst number
application.invoiceCalculations.sgst number
application.invoiceCalculations.igst number
application.invoiceCalculations.serviceChargeAmount number
application.invoiceCalculations.netTotal number
application.invoiceCalculations.grossTotal number
application.invoiceCalculations.calculatedAt string (date-time)
application.travelDate string (date-time)
application.returnDate string (date-time)
application.purpose string

Responses

StatusMeaning
200 The application.
400 The application ID is not a valid 24-character ID.
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 No application with this ID belongs to your account.
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/applications/6661b2c3d4e5f6a7b8c9d0e1" \
  -H "Authorization: Bearer $VISMORA_TOKEN"

Response 200

{
  "success": true,
  "application": {
    "_id": "6661b2c3d4e5f6a7b8c9d0e1",
    "ref": "AE-AGB2C3-001",
    "status": "completed",
    "totalAmount": 12150,
    "discountApplied": 1350,
    "finalAmount": 12150,
    "convenienceFee": 0,
    "couponCode": "WINTER10",
    "viscoinsUsed": 0,
    "notes": [],
    "createdVia": "api",
    "user": "665f1c2ab4e9a3d1f0a1b2c3",
    "country": {
      "_id": "664a0b1c2d3e4f5a6b7c8d9e",
      "name": "United Arab Emirates",
      "code": "AE"
    },
    "visaType": {
      "_id": "6650a1f2c3d4e5f6a7b8c9d0",
      "purpose": "Tourist",
      "price": 7500,
      "variations": [
        {
          "name": "child",
          "price": 6000,
          "description": "Travellers under 12"
        }
      ]
    },
    "visaSeekers": [
      {
        "_id": "6661b2c3d4e5f6a7b8c9d0e2",
        "firstName": "Aarav",
        "lastName": "Mehta",
        "passportNumber": "Z1234567",
        "category": "Adult",
        "isPrimary": true,
        "visaType": "primary",
        "price": 7500,
        "status": "approved",
        "documents": [
          {
            "documentType": "Passport Front",
            "fileName": "passport-front.jpg"
          }
        ],
        "approvalDoc": {
          "available": true,
          "fileName": "AE-AGB2C3-001-aarav-evisa.pdf",
          "downloadUrl": "https://…signed-download-link…",
          "expiresInMinutes": 60
        }
      }
    ],
    "additionalCharges": [],
    "invoiceCalculations": {
      "priceTotal": 13500,
      "totalDiscount": 1350,
      "visaPriceTotal": 13500,
      "additionalChargesNetTotal": 0,
      "totalGST": 0,
      "cgst": 0,
      "sgst": 0,
      "igst": 0,
      "netTotal": 12150,
      "grossTotal": 12150,
      "calculatedAt": "2026-12-02T09:15:00.000Z"
    }
  }
}

Response 400

{
  "success": false,
  "error": "Invalid application ID"
}

Get application status

GET /api/applications/{id}/status

A lightweight status check for polling: the application status plus each traveller's status and, when available, a temporary link to their approval or rejection document. Poll no more than every few minutes per application.

Parameters

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

Response fields

FieldTypeDescription
success boolean
ref string Application reference.
status string 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.
One of: pending assigned in-progress query_raised query_answered completed hold cancelled
passengerStatuses array of objects
passengerStatuses[].firstName string
passengerStatuses[].lastName string
passengerStatuses[].status string pending: not started. WIP: being processed. approved: visa issued. disapproved: visa refused.
One of: pending WIP approved disapproved
passengerStatuses[].approvalDoc object Present only once the document has been issued.
passengerStatuses[].approvalDoc.available boolean
passengerStatuses[].approvalDoc.fileName string
passengerStatuses[].approvalDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
passengerStatuses[].approvalDoc.expiresInMinutes integer
passengerStatuses[].rejectionDoc object Present only once the document has been issued.
passengerStatuses[].rejectionDoc.available boolean
passengerStatuses[].rejectionDoc.fileName string
passengerStatuses[].rejectionDoc.downloadUrl string (uri) Temporary link. Get a new one from the document endpoint after it expires.
passengerStatuses[].rejectionDoc.expiresInMinutes integer
createdAt string (date-time)
updatedAt string (date-time)

Responses

StatusMeaning
200 Current status.
400 The application ID is not a valid 24-character ID.
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 No application with this ID belongs to your account.
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/applications/6661b2c3d4e5f6a7b8c9d0e1/status" \
  -H "Authorization: Bearer $VISMORA_TOKEN"

Response 200

{
  "success": true,
  "ref": "AE-AGB2C3-001",
  "status": "in-progress",
  "passengerStatuses": [
    {
      "firstName": "Aarav",
      "lastName": "Mehta",
      "status": "approved",
      "approvalDoc": {
        "available": true,
        "fileName": "AE-AGB2C3-001-aarav-evisa.pdf",
        "downloadUrl": "https://…signed-download-link…",
        "expiresInMinutes": 60
      }
    },
    {
      "firstName": "Anaya",
      "lastName": "Mehta",
      "status": "WIP"
    }
  ],
  "createdAt": "2026-11-28T10:30:00.000Z",
  "updatedAt": "2026-12-02T09:15:00.000Z"
}

Response 400

{
  "success": false,
  "error": "Invalid application ID"
}

Get a fresh visa document link

GET /api/applications/{id}/passenger/{passengerIndex}/document

Download links in application and status responses expire. Call this to get a new link to a traveller's approval (the issued visa) or rejection document.

Parameters

NameInDescription
id required
string
path Application _id (24 hex characters).
passengerIndex required
integer
path Zero-based position of the traveller in visaSeekers (0 is the primary applicant).
type required
string
query Which document to fetch.
One of: approval rejection

Response fields

FieldTypeDescription
success boolean
type string
One of: approval rejection
passengerIndex integer
fileName string
signedUrl string (uri) Temporary download link. Download the file before it expires.
expiresInMinutes integer

Responses

StatusMeaning
200 A temporary download link.
400 type is missing or not approval/rejection, the passenger index is invalid, or the application ID is malformed.
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 application or traveller doesn't exist, or that document hasn't been issued yet.
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/applications/6661b2c3d4e5f6a7b8c9d0e1/passenger/0/document?type=approval" \
  -H "Authorization: Bearer $VISMORA_TOKEN"

Response 200

{
  "success": true,
  "type": "approval",
  "passengerIndex": 0,
  "fileName": "AE-AGB2C3-001-aarav-evisa.pdf",
  "signedUrl": "https://…signed-download-link…",
  "expiresInMinutes": 60
}

Response 400

{
  "success": false,
  "error": "Query parameter type must be \"approval\" or \"rejection\""
}

Get the invoice

GET /api/applications/{id}/invoice

Returns the GST invoice as a complete HTML document that you can display, save, or convert to PDF. Invoices exist once an application is in-progress or completed. Errors are still returned as JSON.

Parameters

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

Responses

StatusMeaning
200 Invoice HTML.
400 The application is not yet at a stage where an invoice exists.
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 No application with this ID belongs to your account.
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/applications/6661b2c3d4e5f6a7b8c9d0e1/invoice" \
  -H "Authorization: Bearer $VISMORA_TOKEN" \
  -o invoice.html

Response 200

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Invoice</title>
  ...
</head>
<body>
  ...
</body>
</html>

Response 400

{
  "success": false,
  "error": "Invoice is only available for applications in \"In Progress\" or \"Completed\" status."
}