{"openapi":"3.1.0","info":{"title":"Vismora Partner API","version":"1.0.0","summary":"Visa API for travel agents, OTAs and travel-tech platforms.","description":"File visa applications, fetch visa pricing and document requirements, track application and traveller status, download invoices and check your wallet, all from your own system. All responses are JSON, except the invoice endpoint which returns HTML.","contact":{"name":"Vismora API Support","email":"support@vismora.com","url":"https://vismora.com/api-integration"}},"servers":[{"url":"https://api.vismora.com","description":"Production"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Authentication","x-slug":"authentication","x-title":"Authentication API","x-meta-description":"Log in to the Vismora visa API with your partner credentials and get a JWT bearer token to call every other endpoint.","description":"Every endpoint except login needs a bearer token. Log in with the email and password of your approved partner account to get a JWT, then send it on each request in the `Authorization: Bearer <token>` header. Tokens are valid for 7 days. When a request returns `401`, log in again to get a fresh token."},{"name":"Applications","x-slug":"applications","x-title":"Visa Applications API","x-meta-description":"Create visa applications with traveller details and documents, list and track applications, download approval documents and invoices through the Vismora visa API.","description":"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`."},{"name":"Visas","x-slug":"visas","x-title":"Visa Search & Pricing API","x-meta-description":"Search visas by destination country and type, get prices, processing times, required documents and a booking quote for any number of travellers.","description":"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."},{"name":"Countries","x-slug":"countries","x-title":"Countries API","x-meta-description":"Search and list destination countries supported by the Vismora visa API, with country codes, flags and images.","description":"Destination countries with their codes, flag and image URLs. Use a country's `_id` or `code` to filter visas."},{"name":"Ledger","x-slug":"ledger","x-title":"Wallet & Ledger API","x-meta-description":"Check your Vismora wallet balance and list credits and debits, including booking debits linked to visa applications.","description":"Applications are paid from your prepaid Vismora wallet. These endpoints return your current balance and the history of credits (top-ups) and debits (bookings, refunds and fees)."}],"paths":{"/api/auth/login":{"post":{"tags":["Authentication"],"operationId":"login","summary":"Log in and get a token","description":"Exchanges your partner email and password for a JWT valid for 7 days. Failed attempts are rate limited per IP address.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","password"],"properties":{"email":{"type":"string","format":"email","description":"Email address of your partner account."},"password":{"type":"string","description":"Account password."}}},"example":{"email":"partner@yourcompany.com","password":"your-password"}}}},"responses":{"200":{"description":"Logged in.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"token":{"type":"string","description":"JWT to send as `Authorization: Bearer <token>`."},"user":{"$ref":"#/components/schemas/User"}}},"example":{"success":true,"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","user":{"id":"665f1c2ab4e9a3d1f0a1b2c3","firstName":"Riya","lastName":"Shah","email":"partner@yourcompany.com","userType":"agent","companyName":"Skyline Holidays","walletBalance":25000}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"description":"Wrong email or password.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Invalid email or password"}}}},"403":{"description":"The account exists but can't use the API yet: it is disabled, not approved, not a partner account, or API access hasn't been enabled. The `error` message says which.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"API access is not enabled for your account. Please contact support to enable API access."}}}},"429":{"$ref":"#/components/responses/TooManyLogins"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/auth/verify":{"get":{"tags":["Authentication"],"operationId":"verifyToken","summary":"Verify a token","description":"Checks that a token is still valid and returns the account it belongs to, including the current wallet balance.","responses":{"200":{"description":"Token is valid.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"user":{"$ref":"#/components/schemas/User"}}},"example":{"success":true,"user":{"id":"665f1c2ab4e9a3d1f0a1b2c3","firstName":"Riya","lastName":"Shah","email":"partner@yourcompany.com","userType":"agent","companyName":"Skyline Holidays","walletBalance":25000}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/applications":{"post":{"tags":["Applications"],"operationId":"createApplication","summary":"Create an application","description":"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.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApplicationRequest"},"example":{"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"}}}},"responses":{"201":{"description":"Application created.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"pricing":{"$ref":"#/components/schemas/Pricing"},"application":{"$ref":"#/components/schemas/Application"}}},"example":{"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"}]}]}}}}},"400":{"description":"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.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ValidationError"},{"$ref":"#/components/schemas/Error"}]},"example":{"success":false,"error":"Missing required documents for visa seeker 2: Photograph"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"The visa doesn't exist or is no longer offered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Visa not found or inactive"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"description":"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.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Failed to create application"}}}}}},"get":{"tags":["Applications"],"operationId":"listApplications","summary":"List applications","description":"Returns your applications, newest first. In the list view `visaType` only contains `_id`, `purpose` and `price`; fetch a single application for full details.","parameters":[{"$ref":"#/components/parameters/Page"},{"name":"limit","in":"query","description":"Items per page. Maximum 100.","schema":{"type":"integer","default":20,"minimum":1,"maximum":100}},{"name":"status","in":"query","description":"Only return applications in this status.","schema":{"$ref":"#/components/schemas/ApplicationStatus"}}],"responses":{"200":{"description":"A page of applications.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"applications":{"type":"array","items":{"$ref":"#/components/schemas/Application"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"example":{"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}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/applications/{id}":{"get":{"tags":["Applications"],"operationId":"getApplication","summary":"Get an application","description":"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":[{"$ref":"#/components/parameters/ApplicationId"}],"responses":{"200":{"description":"The application.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"application":{"$ref":"#/components/schemas/Application"}}},"example":{"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"}}}}}},"400":{"$ref":"#/components/responses/InvalidApplicationId"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/ApplicationNotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/applications/{id}/status":{"get":{"tags":["Applications"],"operationId":"getApplicationStatus","summary":"Get application status","description":"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":[{"$ref":"#/components/parameters/ApplicationId"}],"responses":{"200":{"description":"Current status.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"ref":{"type":"string","description":"Application reference."},"status":{"$ref":"#/components/schemas/ApplicationStatus"},"passengerStatuses":{"type":"array","items":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"status":{"$ref":"#/components/schemas/PassengerStatus"},"approvalDoc":{"$ref":"#/components/schemas/OutcomeDocument"},"rejectionDoc":{"$ref":"#/components/schemas/OutcomeDocument"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"example":{"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"}}}},"400":{"$ref":"#/components/responses/InvalidApplicationId"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/ApplicationNotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/applications/{id}/passenger/{passengerIndex}/document":{"get":{"tags":["Applications"],"operationId":"getPassengerDocument","summary":"Get a fresh visa document link","description":"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":[{"$ref":"#/components/parameters/ApplicationId"},{"name":"passengerIndex","in":"path","required":true,"description":"Zero-based position of the traveller in `visaSeekers` (0 is the primary applicant).","schema":{"type":"integer","minimum":0}},{"name":"type","in":"query","required":true,"description":"Which document to fetch.","schema":{"type":"string","enum":["approval","rejection"]}}],"responses":{"200":{"description":"A temporary download link.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"type":{"type":"string","enum":["approval","rejection"]},"passengerIndex":{"type":"integer"},"fileName":{"type":"string"},"signedUrl":{"type":"string","format":"uri","description":"Temporary download link. Download the file before it expires."},"expiresInMinutes":{"type":"integer"}}},"example":{"success":true,"type":"approval","passengerIndex":0,"fileName":"AE-AGB2C3-001-aarav-evisa.pdf","signedUrl":"https://…signed-download-link…","expiresInMinutes":60}}}},"400":{"description":"`type` is missing or not `approval`/`rejection`, the passenger index is invalid, or the application ID is malformed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Query parameter type must be \"approval\" or \"rejection\""}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"The application or traveller doesn't exist, or that document hasn't been issued yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Approval document not available for this passenger"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/applications/{id}/invoice":{"get":{"tags":["Applications"],"operationId":"getInvoice","summary":"Get the invoice","description":"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":[{"$ref":"#/components/parameters/ApplicationId"}],"responses":{"200":{"description":"Invoice HTML.","content":{"text/html":{"schema":{"type":"string"},"example":"<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <title>Invoice</title>\n  ...\n</head>\n<body>\n  ...\n</body>\n</html>"}}},"400":{"description":"The application is not yet at a stage where an invoice exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Invoice is only available for applications in \"In Progress\" or \"Completed\" status."}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/ApplicationNotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/visas":{"get":{"tags":["Visas"],"operationId":"listVisas","summary":"List visas","description":"Returns the visas you can file, newest first. Pass `travelStartDate` to find out whether each visa can be processed in time for the trip: if not, `canProcessInTime` is `false` and `readyDate` shows the earliest date it could be ready.","parameters":[{"name":"country","in":"query","description":"Destination country: its `_id`, its exact code (e.g. `AE`), or part of its name (e.g. `emir`).","schema":{"type":"string"}},{"name":"type","in":"query","description":"Only return visas of this purpose.","schema":{"type":"string","enum":["Tourist","Business"]}},{"name":"travelStartDate","in":"query","description":"Planned travel date (YYYY-MM-DD), used to compute `canProcessInTime`.","schema":{"type":"string","format":"date"}},{"name":"travelEndDate","in":"query","description":"Planned return date (YYYY-MM-DD). Echoed back in `filters`.","schema":{"type":"string","format":"date"}},{"$ref":"#/components/parameters/Page"},{"name":"limit","in":"query","description":"Items per page. Maximum 100.","schema":{"type":"integer","default":20,"minimum":1,"maximum":100}}],"responses":{"200":{"description":"A page of visas.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"visas":{"type":"array","items":{"$ref":"#/components/schemas/Visa"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"filters":{"type":"object","description":"The filters that were applied.","properties":{"country":{"type":["string","null"]},"travelStartDate":{"type":["string","null"]},"travelEndDate":{"type":["string","null"]},"type":{"type":["string","null"]}}}}},"example":{"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"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/visas/{id}":{"get":{"tags":["Visas"],"operationId":"getVisa","summary":"Get a visa","description":"Returns one visa with its full list of required documents and variations. Use `requiredDocuments[].name` as the `documentType` when you upload documents.","parameters":[{"$ref":"#/components/parameters/VisaId"}],"responses":{"200":{"description":"The visa.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"visa":{"$ref":"#/components/schemas/Visa"}}},"example":{"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"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/VisaNotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/visas/{id}/quote":{"get":{"tags":["Visas"],"operationId":"getVisaQuote","summary":"Get a price quote","description":"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":[{"$ref":"#/components/parameters/VisaId"},{"name":"passengers","in":"query","required":true,"description":"Number of travellers.","schema":{"type":"integer","minimum":1}},{"name":"visaTypes","in":"query","description":"Comma-separated variation names for travellers 2 to N, in order (the first value applies to traveller 2). Use `primary` for the base price.","schema":{"type":"string"},"example":"child,primary"},{"name":"couponCode","in":"query","description":"Coupon to apply.","schema":{"type":"string"}},{"name":"useViscoins","in":"query","description":"Set to `1` to redeem Viscoins (loyalty points). Can't be combined with a coupon.","schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"The quote.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"visa":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"purpose":{"type":"string"},"price":{"type":"number"},"country":{"$ref":"#/components/schemas/CountrySummary"}}},"pricing":{"$ref":"#/components/schemas/Pricing"}}},"example":{"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."}}}}},"400":{"description":"`passengers` is missing or less than 1.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Query parameter \"passengers\" is required and must be at least 1"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/VisaNotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/visas/countries/list":{"get":{"tags":["Visas"],"operationId":"listVisaCountries","summary":"List countries for visa filters","description":"All active destination countries with just their name and code, sorted by name. Handy for a country picker in front of the visa list.","responses":{"200":{"description":"Countries.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"countries":{"type":"array","items":{"$ref":"#/components/schemas/CountrySummary"}}}},"example":{"success":true,"countries":[{"_id":"664a0b1c2d3e4f5a6b7c8d9e","name":"United Arab Emirates","code":"AE"},{"_id":"664a0b1c2d3e4f5a6b7c8d9f","name":"Vietnam","code":"VN"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/countries/search":{"get":{"tags":["Countries"],"operationId":"searchCountries","summary":"Search countries","description":"Case-insensitive search on country name or code. The query must be at least 3 characters.","parameters":[{"name":"q","in":"query","required":true,"description":"Search text, at least 3 characters.","schema":{"type":"string","minLength":3}},{"name":"limit","in":"query","description":"Maximum results. Maximum 100.","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Matching countries.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"query":{"type":"string","description":"The search text used."},"count":{"type":"integer"},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}}},"example":{"success":true,"query":"thai","count":1,"countries":[{"_id":"664a0b1c2d3e4f5a6b7c8da0","name":"Thailand","code":"TH","flag":"https://flagcdn.com/w80/th.png","image":"https://…/thailand.jpg"}]}}}},"400":{"description":"The search text is shorter than 3 characters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Search query must be at least 3 characters long"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/countries/list":{"get":{"tags":["Countries"],"operationId":"listCountries","summary":"List countries","description":"All active countries, sorted by name.","parameters":[{"name":"limit","in":"query","description":"Maximum results. Maximum 500.","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"Countries.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"count":{"type":"integer"},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}}},"example":{"success":true,"count":2,"countries":[{"_id":"664a0b1c2d3e4f5a6b7c8da0","name":"Thailand","code":"TH","flag":"https://flagcdn.com/w80/th.png","image":"https://…/thailand.jpg"},{"_id":"664a0b1c2d3e4f5a6b7c8d9e","name":"United Arab Emirates","code":"AE","flag":"https://flagcdn.com/w80/ae.png","image":"https://…/uae.jpg"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/countries/{id}":{"get":{"tags":["Countries"],"operationId":"getCountry","summary":"Get a country","description":"Returns one country by its `_id` or its code.","parameters":[{"name":"id","in":"path","required":true,"description":"Country `_id` or code, e.g. `TH`.","schema":{"type":"string"}}],"responses":{"200":{"description":"The country.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"country":{"$ref":"#/components/schemas/Country"}}},"example":{"success":true,"country":{"_id":"664a0b1c2d3e4f5a6b7c8da0","name":"Thailand","code":"TH","flag":"https://flagcdn.com/w80/th.png","image":"https://…/thailand.jpg","showOnHomepage":true}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"No active country with that ID or code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Country not found"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/ledger":{"get":{"tags":["Ledger"],"operationId":"listLedger","summary":"List wallet transactions","description":"Your wallet credits and debits, newest first. Date filters apply to the date the entry was created; both ends are inclusive.","parameters":[{"$ref":"#/components/parameters/Page"},{"name":"limit","in":"query","description":"Items per page. Maximum 100.","schema":{"type":"integer","default":50,"minimum":1,"maximum":100}},{"name":"transactionType","in":"query","description":"Only credits or only debits.","schema":{"type":"string","enum":["credit","debit"]}},{"name":"status","in":"query","description":"Only entries in this status.","schema":{"$ref":"#/components/schemas/TransactionStatus"}},{"name":"startDate","in":"query","description":"From this date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"Up to and including this date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"A page of ledger entries.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"ledger":{"type":"array","items":{"$ref":"#/components/schemas/LedgerEntry"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"example":{"success":true,"ledger":[{"_id":"6662c3d4e5f6a7b8c9d0e1f2","transactionType":"debit","amount":12150,"status":"approved","debitType":"booking","details":"Booking AE-AGB2C3-001","debitDate":"2026-11-29T06:00:00.000Z","bookingId":{"_id":"6661b2c3d4e5f6a7b8c9d0e1","ref":"AE-AGB2C3-001","status":"in-progress"},"createdAt":"2026-11-29T06:00:00.000Z","approvedAt":"2026-11-29T06:00:00.000Z"},{"_id":"6662c3d4e5f6a7b8c9d0e1f1","transactionType":"credit","amount":50000,"status":"approved","paymentReference":"UTR402611250001","paymentMode":"NEFT","fromBank":"HDFC Bank","creditDate":"2026-11-25T00:00:00.000Z","createdAt":"2026-11-25T11:20:00.000Z","approvedAt":"2026-11-25T14:05:00.000Z"}],"pagination":{"page":1,"limit":50,"total":2,"pages":1}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/ledger/balance":{"get":{"tags":["Ledger"],"operationId":"getBalance","summary":"Get wallet balance","description":"Your current wallet balance, plus the totals of approved credits and debits.","responses":{"200":{"description":"Balance.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"balance":{"type":"number","description":"Current wallet balance in INR. Use this figure."},"calculatedBalance":{"type":"number","description":"Approved credits minus approved debits, for reconciliation."},"totalCredits":{"type":"number","description":"Sum of approved credits in INR."},"totalDebits":{"type":"number","description":"Sum of approved debits in INR."}}},"example":{"success":true,"balance":37850,"calculatedBalance":37850,"totalCredits":50000,"totalDebits":12150}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"The account no longer exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"User not found"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Token from `POST /api/auth/login`, valid for 7 days."}},"parameters":{"Page":{"name":"page","in":"query","description":"Page number, starting at 1.","schema":{"type":"integer","default":1,"minimum":1}},"ApplicationId":{"name":"id","in":"path","required":true,"description":"Application `_id` (24 hex characters).","schema":{"type":"string","pattern":"^[a-fA-F0-9]{24}$"}},"VisaId":{"name":"id","in":"path","required":true,"description":"Visa `_id` (24 hex characters).","schema":{"type":"string"}}},"responses":{"ValidationError":{"description":"One or more fields are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"},"example":{"success":false,"errors":[{"type":"field","msg":"Valid email is required","path":"email","location":"body"}]}}}},"Unauthorized":{"description":"The token is missing, invalid or expired. Log in again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Invalid or expired token. Please login again."}}}},"Forbidden":{"description":"The account was disabled, unapproved or had API access turned off after the token was issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Account is disabled. Please contact support."}}}},"TooManyRequests":{"description":"Rate limit reached. Wait for the number of seconds in the `Retry-After` header, then retry.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"RateLimit":{"description":"Current limit, remaining requests and seconds until reset, e.g. `limit=120, remaining=0, reset=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Too many requests. Please slow down and retry after the time given in the Retry-After header."}}}},"TooManyLogins":{"description":"Too many failed login attempts from your IP address. Wait for the number of seconds in the `Retry-After` header.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Too many failed login attempts. Please try again later."}}}},"ServerError":{"description":"Something went wrong on our side. Retry later, and contact support if it continues.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Internal server error"}}}},"InvalidApplicationId":{"description":"The application ID is not a valid 24-character ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Invalid application ID"}}}},"ApplicationNotFound":{"description":"No application with this ID belongs to your account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Application not found"}}}},"VisaNotFound":{"description":"The visa doesn't exist or is no longer offered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"Visa not found"}}}}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"string","description":"Human-readable error message."}}},"ValidationError":{"type":"object","properties":{"success":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"object","properties":{"msg":{"type":"string","description":"What is wrong."},"path":{"type":"string","description":"The field, e.g. `visaSeekers[0].firstName`."},"location":{"type":"string","description":"Where the field was sent, usually `body`."}}}}}},"Pagination":{"type":"object","properties":{"page":{"type":"integer","description":"Current page."},"limit":{"type":"integer","description":"Items per page."},"total":{"type":"integer","description":"Total matching items."},"pages":{"type":"integer","description":"Total pages."}}},"User":{"type":"object","properties":{"id":{"type":"string","description":"Account ID."},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string","format":"email"},"userType":{"type":"string","enum":["agent","individual"]},"companyName":{"type":"string"},"walletBalance":{"type":"number","description":"Wallet balance in INR."}}},"ApplicationStatus":{"type":"string","description":"`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.","enum":["pending","assigned","in-progress","query_raised","query_answered","completed","hold","cancelled"]},"PassengerStatus":{"type":"string","description":"`pending`: not started. `WIP`: being processed. `approved`: visa issued. `disapproved`: visa refused.","enum":["pending","WIP","approved","disapproved"]},"TransactionStatus":{"type":"string","description":"Only `approved` entries affect your balance.","enum":["approved","pending","rejected"]},"CountrySummary":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. `AE`."}}},"Country":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. `TH`."},"flag":{"type":"string","format":"uri","description":"Flag image URL."},"image":{"type":"string","format":"uri","description":"Destination image URL."},"showOnHomepage":{"type":"boolean","description":"Only returned by `GET /api/countries/{id}`."}}},"RequiredDocument":{"type":"object","properties":{"name":{"type":"string","description":"Document name. Send this exact value as `documentType` when uploading."},"description":{"type":"string","description":"What the document must show."},"mandatory":{"type":"boolean","description":"Whether every traveller must provide it."}}},"Variation":{"type":"object","description":"An alternative price for some travellers on the same visa, e.g. children.","properties":{"name":{"type":"string","description":"Send this as a traveller's `visaType` to use this price."},"price":{"type":"number","description":"Price per traveller in INR."},"description":{"type":"string"},"ageBracket":{"type":"string","description":"Age range the variation applies to, when set."},"relation":{"type":"string","description":"Relationship to the primary applicant the variation applies to, when set."}}},"Visa":{"type":"object","properties":{"_id":{"type":"string","description":"Visa ID. Use it as `visaId` when creating an application."},"name":{"type":"string","description":"Display name."},"purpose":{"type":"string","description":"e.g. `Tourist`, `Business`."},"description":{"type":"string"},"price":{"type":"number","description":"Base price per traveller in INR."},"category":{"type":"string","description":"e.g. `e-Visa`, `Sticker`."},"processingTimeInDays":{"type":"integer","description":"Processing time in business days."},"requiredProcurementDays":{"type":"integer","description":"Business days needed end to end, including document collection."},"duration":{"type":"string","description":"Permitted stay, e.g. `30 Days`."},"entry":{"type":"string","description":"`Single` or `Multiple`."},"validityInDays":{"type":"integer","description":"Days the visa stays valid from issue."},"notes":{"type":"string"},"country":{"$ref":"#/components/schemas/CountrySummary"},"requiredDocuments":{"type":"array","items":{"$ref":"#/components/schemas/RequiredDocument"}},"variations":{"type":"array","items":{"$ref":"#/components/schemas/Variation"}},"visaByDate":{"type":"string","format":"date-time","description":"Estimated date the visa would be ready if you apply today."},"visaByDateFormatted":{"type":"string","description":"`visaByDate` formatted for display (IST)."},"canProcessInTime":{"type":"boolean","description":"List endpoint only. Whether the visa can be ready by `travelStartDate`. Always `true` when no travel date is given."},"readyDate":{"type":"string","format":"date","description":"List endpoint only, when `canProcessInTime` is `false`: earliest ready date."},"requiredProcessingDays":{"type":"integer","description":"List endpoint only, when `canProcessInTime` is `false`."}}},"DocumentUpload":{"type":"object","required":["documentType","fileName","fileData"],"properties":{"documentType":{"type":"string","description":"Must equal a `requiredDocuments[].name` of the visa."},"fileName":{"type":"string","description":"Original file name, including extension."},"fileData":{"type":"string","contentEncoding":"base64","description":"File content as base64. A `data:…;base64,` prefix is accepted. Up to 10 MB decoded."},"mimeType":{"type":"string","description":"e.g. `application/pdf`, `image/jpeg`. Worked out from the file name when omitted."}}},"VisaSeekerInput":{"type":"object","required":["firstName","lastName","category"],"properties":{"firstName":{"type":"string","description":"As printed on the passport."},"lastName":{"type":"string","description":"As printed on the passport."},"category":{"type":"string","enum":["Adult","Child"]},"passportNumber":{"type":"string"},"mobile":{"type":"string","description":"With country code, e.g. `+919800000001`."},"email":{"type":"string","format":"email"},"occupation":{"type":"string"},"visaType":{"type":"string","description":"For travellers after the first: a variation `name`, or `primary` for the base price (default). Ignored for the first traveller."},"documents":{"type":"array","description":"Documents for this traveller. Must cover every mandatory document of the visa.","items":{"$ref":"#/components/schemas/DocumentUpload"}}}},"CreateApplicationRequest":{"type":"object","required":["visaId","visaSeekers"],"properties":{"visaId":{"type":"string","description":"The visa `_id` to apply for."},"visaSeekers":{"type":"array","minItems":1,"description":"Travellers. The first one is the primary applicant.","items":{"$ref":"#/components/schemas/VisaSeekerInput"}},"travelStartDate":{"type":"string","format":"date","description":"Planned travel date (YYYY-MM-DD)."},"travelEndDate":{"type":"string","format":"date","description":"Planned return date (YYYY-MM-DD)."},"couponCode":{"type":"string","description":"Discount coupon. An invalid coupon is ignored, not rejected."},"useViscoins":{"type":"boolean","description":"Redeem Viscoins (loyalty points) instead of a coupon."}}},"Pricing":{"type":"object","description":"Price breakdown. Prices are per traveller and already summed.","properties":{"visaPrice":{"type":"number","description":"Base visa price per traveller in INR."},"passengerCount":{"type":"integer"},"subtotal":{"type":"number","description":"Sum of traveller prices before discount."},"discountApplied":{"type":"number","description":"Coupon or Viscoins discount."},"convenienceFee":{"type":"number"},"totalAmount":{"type":"number","description":"Amount payable: subtotal − discount + convenience fee. Do not multiply by passenger count."},"passengers":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position in `visaSeekers`."},"visaType":{"type":"string"},"price":{"type":"number"}}}},"note":{"type":"string"}}},"OutcomeDocument":{"type":"object","description":"Present only once the document has been issued.","properties":{"available":{"type":"boolean"},"fileName":{"type":"string"},"downloadUrl":{"type":"string","format":"uri","description":"Temporary link. Get a new one from the document endpoint after it expires."},"expiresInMinutes":{"type":"integer"}}},"VisaSeeker":{"type":"object","properties":{"_id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"passportNumber":{"type":"string"},"category":{"type":"string","enum":["Adult","Child"]},"mobile":{"type":"string"},"email":{"type":"string"},"occupation":{"type":"string"},"isPrimary":{"type":"boolean","description":"`true` for the first traveller."},"visaType":{"type":"string","description":"`primary` or a variation name."},"price":{"type":"number","description":"Price for this traveller in INR."},"status":{"$ref":"#/components/schemas/PassengerStatus"},"documents":{"type":"array","description":"Uploaded documents. File locations are never exposed.","items":{"type":"object","properties":{"documentType":{"type":"string"},"fileName":{"type":"string"}}}},"approvalDoc":{"$ref":"#/components/schemas/OutcomeDocument"},"rejectionDoc":{"$ref":"#/components/schemas/OutcomeDocument"}}},"Application":{"type":"object","properties":{"_id":{"type":"string","description":"Application ID."},"ref":{"type":"string","description":"Human-readable reference, e.g. `AE-AGB2C3-001`. Quote it when contacting support."},"status":{"$ref":"#/components/schemas/ApplicationStatus"},"totalAmount":{"type":"number","description":"Amount payable in INR, after discount and including the convenience fee."},"discountApplied":{"type":"number","description":"Discount in INR."},"finalAmount":{"type":"number","description":"Same as `totalAmount`."},"convenienceFee":{"type":"number"},"couponCode":{"type":"string"},"viscoinsUsed":{"type":"number","description":"Viscoins redeemed."},"notes":{"type":"array","items":{},"description":"Notes added during processing."},"createdVia":{"type":"string","enum":["api","website","admin"],"description":"Where the application was created."},"user":{"type":"string","description":"Your account ID."},"country":{"$ref":"#/components/schemas/Country"},"visaType":{"$ref":"#/components/schemas/Visa"},"visaSeekers":{"type":"array","items":{"$ref":"#/components/schemas/VisaSeeker"}},"additionalCharges":{"type":"array","description":"Extra charges added during processing.","items":{"type":"object","properties":{"description":{"type":"string"},"amount":{"type":"number"},"addedAt":{"type":"string","format":"date-time"}}}},"invoiceCalculations":{"type":"object","description":"Invoice breakdown in INR, once the application is being processed.","properties":{"priceTotal":{"type":"number"},"totalDiscount":{"type":"number"},"taxableAmountIncludingGST":{"type":"number"},"visaPriceTotal":{"type":"number"},"additionalChargesNetTotal":{"type":"number"},"totalGST":{"type":"number"},"cgst":{"type":"number"},"sgst":{"type":"number"},"igst":{"type":"number"},"serviceChargeAmount":{"type":"number"},"netTotal":{"type":"number"},"grossTotal":{"type":"number"},"calculatedAt":{"type":"string","format":"date-time"}}},"travelDate":{"type":"string","format":"date-time"},"returnDate":{"type":"string","format":"date-time"},"purpose":{"type":"string"}}},"LedgerEntry":{"type":"object","properties":{"_id":{"type":"string"},"transactionType":{"type":"string","enum":["credit","debit"]},"amount":{"type":"number","description":"Amount in INR."},"status":{"$ref":"#/components/schemas/TransactionStatus"},"paymentReference":{"type":"string","description":"Credits: bank or UPI reference."},"paymentMode":{"type":"string","enum":["UPI","NEFT","RTGS","IMPS","Bank Transfer","Other"],"description":"Credits: how the top-up was paid."},"fromBank":{"type":"string","description":"Credits: paying bank."},"creditDate":{"type":"string","format":"date-time","description":"Credits: date of payment."},"debitType":{"type":"string","enum":["booking","refund","fee","other"],"description":"Debits: what the debit is for."},"details":{"type":"string","description":"Debits: description."},"debitDate":{"type":"string","format":"date-time"},"bookingId":{"type":"object","description":"Debits for a booking: the related application.","properties":{"_id":{"type":"string"},"ref":{"type":"string"},"status":{"$ref":"#/components/schemas/ApplicationStatus"}}},"createdAt":{"type":"string","format":"date-time"},"approvedAt":{"type":"string","format":"date-time"}}}}}}