---
title: "Get the balance"
description: "Returns every detail of the prepaid balance. That covers the ledger total, pending mention charges, the effective balance used for pausing, the daily spend and days left, running and paused keywords, the cost of a day and of resuming, the welcome credit, the latest top-up, the top-up limits and the auto-recharge settings. `GET /v1/usage` gives a shorter version."
canonical: https://docs.rumoro.dev/api/billing/get-wallet
markdown: https://docs.rumoro.dev/api/billing/get-wallet.mdx
---

# Get the balance

`GET /v1/billing/wallet`

Returns every detail of the prepaid balance. That covers the ledger total, pending mention charges, the effective balance used for pausing, the daily spend and days left, running and paused keywords, the cost of a day and of resuming, the welcome credit, the latest top-up, the top-up limits and the auto-recharge settings. `GET /v1/usage` gives a shorter version.

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Wallet balance, daily spend and pause state |
| 401 | The credential is missing or not valid |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).