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
| Name | In | Description |
|---|---|---|
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
| Field | Type | Description |
|---|---|---|
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
| Status | Meaning |
|---|---|
| 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
| Field | Type | Description |
|---|---|---|
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
| Status | Meaning |
|---|---|
| 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."
}