---
title: "Get the wallet"
method: GET
path: "/v1/billing/wallet"
tags: ["Billing"]
---

# Get the wallet

`GET /v1/billing/wallet`

## Request

- Base URL: `https://api.mentio.dev`
- URL: `https://api.mentio.dev/v1/billing/wallet`
- Auth: HTTP bearer

The prepaid balance in full: ledger, pending mention charges and the effective balance the stop rule reads, the daily burn and the days it buys, how many keywords run and how many the wallet paused, what a day costs and what a resume needs, the welcome credit, the newest top-up, the top-up bounds and the auto-recharge settings. `GET /v1/usage` is the short form.

## Response `200`

Balance, burn, and whether tracking is paused

- Wallet
  - `balanceCents` integer, required: Ledger balance: every credit minus every settled debit.
  - `pendingCents` integer, required: Mentions and comments billed since the last daily settlement, priced but not yet debited.
  - `effectiveBalanceCents` integer, required: balanceCents minus pendingCents: what the stop sweep and the keyword gate look at.
  - `burnPerDayCents` integer, required: Average daily debit over the last 7 days (or since the workspace was created).
  - `daysLeft` integer, nullable, required: effectiveBalanceCents divided by burnPerDayCents; null when nothing is burning.
  - `stopped` boolean, required: The wallet paused tracking; a top-up that covers a day of every keyword resumes it.
  - `lowBalance` boolean, required: Running, and the effective balance is at or under 20 percent of the last credit: the same rule as the low-balance email.
  - `activeKeywords` integer, required: Unmuted keywords.
  - `autoMutedKeywords` integer, required: Keywords the wallet paused; a top-up resumes them.
  - `nextDayCents` integer, required: What one more day of the running keywords costs; tracking stops when the effective balance drops under it.
  - `resumeCostCents` integer, required: What one day of every keyword (running and paused) costs; a stopped workspace resumes once the effective balance covers it.
  - `signupCredit` object, nullable, required: The welcome credit this workspace received, or null (a second workspace of the same user gets none).
    - `amountCents` integer, required: Integer USD cents.
    - `grantedAt` string, required: ISO 8601 timestamp, UTC.
  - `lastTopUpAt` string, nullable, required: Newest paid top-up; null before the first.
  - `billingConfigured` boolean, required: False when this deployment has no Polar credentials: the top-up button is hidden.
  - `minTopUpCents` integer, required: Smallest top-up the checkout accepts.
  - `maxTopUpCents` integer, required: Largest single top-up.
  - `defaultTopUpCents` integer, required: Amount prefilled in the checkout.
  - `currency` 'USD', required: Every amount on this page is in USD cents.
  - `autoRecharge` object, required
    - `available` boolean, required: This deployment can charge saved cards; false hides the setting.
    - `enabled` boolean, required: Charge the saved card automatically when the balance runs low.
    - `thresholdCents` integer, required: Charge when the effective balance drops under this.
    - `amountCents` integer, required: How much to add per automatic charge (same bounds as a manual top-up).
    - `weeklyLimitCents` integer, nullable, required: Most the saved card may be charged automatically over any 7 days, before tax; null = no limit.
    - `spentThisWeekCents` integer, required: What counts against the weekly limit over the last 7 days, before tax: automatic charges made plus any still settling.
    - `lastRunAt` string, nullable, required: Newest successful automatic charge.
    - `lastError` string, nullable, required: Why the last automatic charge failed; null after a success.

## Other responses

- `401`: Missing or invalid credentials

---

[API](https://skmtc.dev/mentio/apis/mentio-api.md) · [All operations](https://skmtc.dev/mentio/apis/mentio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mentio/apis/mentio-api/revisions/b16a21d0ed02?raw)