API Docs

Wallet & Ledger API

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).

Base URL https://api.vismora.com

List wallet transactions

GET /api/ledger

Your wallet credits and debits, newest first. Date filters apply to the date the entry was created; both ends are inclusive.

Parameters

NameInDescription
page optional
integer
query Page number, starting at 1.
Default: 1
limit optional
integer
query Items per page. Maximum 100.
Default: 50
transactionType optional
string
query Only credits or only debits.
One of: credit debit
status optional
string
query Only entries in this status.
One of: approved pending rejected
startDate optional
string (date)
query From this date (YYYY-MM-DD).
endDate optional
string (date)
query Up to and including this date (YYYY-MM-DD).

Response fields

FieldTypeDescription
success boolean
ledger array of objects
ledger[]._id string
ledger[].transactionType string
One of: credit debit
ledger[].amount number Amount in INR.
ledger[].status string Only approved entries affect your balance.
One of: approved pending rejected
ledger[].paymentReference string Credits: bank or UPI reference.
ledger[].paymentMode string Credits: how the top-up was paid.
One of: UPI NEFT RTGS IMPS Bank Transfer Other
ledger[].fromBank string Credits: paying bank.
ledger[].creditDate string (date-time) Credits: date of payment.
ledger[].debitType string Debits: what the debit is for.
One of: booking refund fee other
ledger[].details string Debits: description.
ledger[].debitDate string (date-time)
ledger[].bookingId object Debits for a booking: the related application.
ledger[].bookingId._id string
ledger[].bookingId.ref string
ledger[].bookingId.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
ledger[].createdAt string (date-time)
ledger[].approvedAt string (date-time)
pagination object
pagination.page integer Current page.
pagination.limit integer Items per page.
pagination.total integer Total matching items.
pagination.pages integer Total pages.

Responses

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

Response 200

{
  "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
  }
}

Response 401

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

Get wallet balance

GET /api/ledger/balance

Your current wallet balance, plus the totals of approved credits and debits.

Response fields

FieldTypeDescription
success boolean
balance number Current wallet balance in INR. Use this figure.
calculatedBalance number Approved credits minus approved debits, for reconciliation.
totalCredits number Sum of approved credits in INR.
totalDebits number Sum of approved debits in INR.

Responses

StatusMeaning
200 Balance.
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 account no longer exists.
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/ledger/balance" \
  -H "Authorization: Bearer $VISMORA_TOKEN"

Response 200

{
  "success": true,
  "balance": 37850,
  "calculatedBalance": 37850,
  "totalCredits": 50000,
  "totalDebits": 12150
}

Response 401

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