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
/api/applications
Create an application
GET
/api/applications
List applications
GET
/api/applications/{id}
Get an application
GET
/api/applications/{id}/status
Get application status
GET
/api/applications/{id}/passenger/{passengerIndex}/document
Get a fresh visa document link
GET
/api/applications/{id}/invoice
Get the invoice
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
| Field | Type | Description |
|---|---|---|
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
| Field | Type | Description |
|---|---|---|
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
| Status | Meaning |
|---|---|
| 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
| Name | In | Description |
|---|---|---|
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
| Field | Type | Description |
|---|---|---|
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
| Status | Meaning |
|---|---|
| 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
| Name | In | Description |
|---|---|---|
id
required
string
|
path |
Application _id (24 hex characters).
|
Response fields
| Field | Type | Description |
|---|---|---|
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
| Status | Meaning |
|---|---|
| 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
| Name | In | Description |
|---|---|---|
id
required
string
|
path |
Application _id (24 hex characters).
|
Response fields
| Field | Type | Description |
|---|---|---|
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
| Status | Meaning |
|---|---|
| 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
| Name | In | Description |
|---|---|---|
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
| Field | Type | Description |
|---|---|---|
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
| Status | Meaning |
|---|---|
| 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
| Name | In | Description |
|---|---|---|
id
required
string
|
path |
Application _id (24 hex characters).
|
Responses
| Status | Meaning |
|---|---|
| 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."
}