---
title: "Get this month's Tally AI usage"
method: GET
path: "/tally/usage"
tags: ["Tally"]
---

# Get this month's Tally AI usage

`GET /tally/usage`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/tally/usage`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns the firm's current UTC-month usage of the LedgerHQ-managed Tally allowance ($5 per included Tally workspace: the Pro firm workspace plus active managed companies, or the SMB firm workspace as its first Tally business): state, spentCents, and limitCents, plus the period reset date, banked rollover credit (summary.bankedCents — unused included usage rolls forward up to $3 per included workspace per month, $250 firm cap), and purchased pack balance (summary.purchasedCents — $25 packs at $26 with $1 card-fee cushion, carries until spent). summary.allowancePack describes the buyable pack. Amounts are integer cents. Never returns secrets.

## Response `200`

Secret-free monthly managed-allowance usage

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)