curl --request GET \
--url https://app.thinnest.ai/api/v1/wallet/ledger \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/wallet/ledger', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/wallet/ledger"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "txn_5b1e7c2a-9f04-4d6e-8a31-2c7d0e9b4f18",
"kind": "voice_call",
"description": "Call, 3 min",
"amountMicro": -18400000,
"balanceAfterMicro": 1831600000,
"currency": "INR",
"customer": null,
"createdAt": "2026-10-06T10:17:30.000Z"
},
{
"id": "txn_0c9d4e2f-7a18-4b53-9e60-1f8a2d3c5b74",
"kind": "topup",
"description": "Money added",
"amountMicro": 1000000000,
"balanceAfterMicro": 1850000000,
"currency": "INR",
"customer": null,
"createdAt": "2026-10-05T08:02:11.000Z"
}
],
"nextCursor": null
}List Wallet Ledger
The balance history — every top-up, reply, call, WhatsApp message, number rental, refund and adjustment, newest first, with the balance after each (Settings → Billing → History). A developer’s charges for its customers land on its own ledger, each naming the customer; customer narrows to one (read with your own key, no Thinnest-Workspace header). Reads only: money is added in the console. Any key may call this, a read-only key included.
curl --request GET \
--url https://app.thinnest.ai/api/v1/wallet/ledger \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/wallet/ledger', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/wallet/ledger"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "txn_5b1e7c2a-9f04-4d6e-8a31-2c7d0e9b4f18",
"kind": "voice_call",
"description": "Call, 3 min",
"amountMicro": -18400000,
"balanceAfterMicro": 1831600000,
"currency": "INR",
"customer": null,
"createdAt": "2026-10-06T10:17:30.000Z"
},
{
"id": "txn_0c9d4e2f-7a18-4b53-9e60-1f8a2d3c5b74",
"kind": "topup",
"description": "Money added",
"amountMicro": 1000000000,
"balanceAfterMicro": 1850000000,
"currency": "INR",
"customer": null,
"createdAt": "2026-10-05T08:02:11.000Z"
}
],
"nextCursor": null
}Authorizations
Your API key (ta_live_…) from Settings → API keys, sent as Authorization: Bearer <key>. Keep it on a server: it can message every customer you have. A key is full, build or read-only; a request its level does not allow is refused with 403.
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace.
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Query Parameters
How many items to return, 1 to 100.
1 <= x <= 100The nextCursor from the previous page. Leave it out for the first page.
First day, YYYY-MM-DD, inclusive, in your workspace's time zone. Optional; either end alone is allowed.
Last day, YYYY-MM-DD, inclusive, in your workspace's time zone. Optional.
Only rows of this kind.
topup, reply, voice_call, wa_message, number_rental, adjustment, refund, plan_credit, plan_credit_expiry, client_usage, client_plan Developers: only charges for this customer workspace.