> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamfollowup.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the public API base URL: https://api.teamfollowup.ai/api.
> Authenticate public API requests with Authorization: Bearer YOUR_API_KEY.
> Use product-owned terms: agents, campaigns, projects (GoHighLevel sub-accounts), contacts, calls, outcomes, skills, cadences, phone numbers.
> Scope requests by locationId rather than projectName.
> Read the guide linked from each API reference group before recommending an endpoint.

# Billing API

> Billing for your agency: where you stand, what moved your wallet, what a window cost, invoices and receipts, every sub-account's wallet, and the changes an agency admin can make.

Every figure these endpoints return is explained in
[Balances, spend and sub-account wallets](/billing/overview). Start with the
summary; use the lists for the detail behind a number.

| Endpoint                                                                      | Use it to                                                                                          |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| [Get billing summary](/api-reference/billing/get-billing-summary)             | See balance, auto-recharge, subscription, this month's spend and what needs attention in one call. |
| [List billing transactions](/api-reference/billing/list-billing-transactions) | Read everything that moved your wallet, filtered by `type` or `locationId`.                        |
| [Get billing usage](/api-reference/billing/get-billing-usage)                 | Total a window by sub-account or by day.                                                           |
| [List billing documents](/api-reference/billing/list-billing-documents)       | List subscription invoices and top-up receipts.                                                    |
| [List sub-account wallets](/api-reference/billing/list-sub-account-wallets)   | See every sub-account's balance, rebilling rate and Credit Guard.                                  |
| [Get sub-account wallet](/api-reference/billing/get-sub-account-wallet)       | Read one sub-account's credit batches and pending credits.                                         |

To change billing:

| Endpoint                                                                                            | Use it to                                                 |
| --------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| [Update agency auto-recharge](/api-reference/billing/update-agency-auto-recharge)                   | Switch auto-recharge on or off and pick the plan it buys. |
| [Buy a plan](/api-reference/billing/buy-a-plan)                                                     | Buy minutes for your wallet.                              |
| [Update sub-account rebilling](/api-reference/billing/update-sub-account-rebilling)                 | Turn rebilling on or off for a sub-account.               |
| [Enable rebilling with a charge](/api-reference/billing/enable-rebilling-with-a-charge)             | Turn rebilling on and charge the client in one step.      |
| [Charge a sub-account](/api-reference/billing/charge-a-sub-account)                                 | Top up a sub-account from the client's card.              |
| [Update sub-account auto-recharge](/api-reference/billing/update-sub-account-auto-recharge)         | Top a sub-account up automatically.                       |
| [Update sub-account Credit Guard](/api-reference/billing/update-sub-account-credit-guard)           | Stop a sub-account's calls when its wallet is empty.      |
| [Update Credit Guard for sub-accounts](/api-reference/billing/update-credit-guard-for-sub-accounts) | The same, for many at once.                               |
| [Link a Stripe customer](/api-reference/billing/link-a-stripe-customer)                             | Link a client's Stripe customer to sub-accounts.          |
| [Unlink a Stripe customer](/api-reference/billing/unlink-a-stripe-customer)                         | Unlink it.                                                |

Every endpoint covers the agency your key belongs to, and only an agency
admin's credential can use them.

Scopes: `billing:read` to read, `billing:write` to change settings, and
`billing:charge` to charge a card, which needs an `Idempotency-Key` and is not
available over MCP. See [Authentication](/authentication#scopes).

## Guides

* [Balances, spend and sub-account wallets](/billing/overview)
* [Set up rebilling for a sub-account](/billing/set-up-rebilling)
* [Agencies, projects and sub-accounts](/concepts/projects)
* [Glossary](/glossary#billing)