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

# Billing

> See what every connected provider has billed you this period.

**Billing** in the Desktop sidebar collects what each connected provider reports about money and usage. Hoista never estimates cost. Every number comes from the provider, and the provider's own invoice is final.

![The Billing screen with the period total, per-account bills, Neon plan usage and providers that only link to billing](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/billing-light.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=468ade193a00f747ea425081ec1d96cf)

![The Billing screen with the period total, per-account bills, Neon plan usage and providers that only link to billing](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/billing-dark.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=86d8c330ddb432f0935dab0e7582dc40)

Billing for Sam’s accounts. Cloudflare and Railway report a bill, Neon reports plan usage, and the rest link to their own billing pages.

## What the page shows

| Section | What it shows |
| - | - |
| **Billed so far this period** | The total across providers that share a bill through their API, and which providers it covers |
| **Next period ends** | The earliest end of a billing period that a provider reported |
| **Limits** | Whether any provider is over a spend limit or alert you set there, and how close the nearest one is |
| **Billed this period** | One row per account with the amount, its limit, the billing period and **Open billing ↗** |
| **Plan usage** | For providers that share usage but not a bill, such as Resend emails and Neon compute hours, against the plan's limit where there is one |
| **On the provider only** | Providers that don't share billing through their API, with a link to their billing page |

## What each provider shares

| Provider | On Billing |
| - | - |
| Railway, Runpod, Modal | What the provider has billed this period, and limits where set |
| Cloudflare | What it has billed this period, for self-serve accounts. The API token needs **Billing Read**. |
| Vercel | What it has billed the team this period |
| Resend, Neon | Plan usage (Neon on paid plans) |
| Fly.io, Render, Supabase, GitHub | A link to the provider's billing page |

Billing covers every account whichever [environment](https://docs.hoista.dev/guides/environments.md) you are viewing, because providers bill per account. Hoista does not split a bill across projects.

## From the CLI

```bash theme={null}
hoist billing
```

It prints the same numbers as a table, or JSON with `--json`.

## From an agent

Agents read the same numbers with the `get_bills` tool. For per-day measurements of a project, see [metrics and usage](https://docs.hoista.dev/guides/logs.md).

## Related

> [card] [Logs and metrics](https://docs.hoista.dev/guides/logs.md)
>
> Per-day usage for a project.

> [card] [Providers](https://docs.hoista.dev/providers/overview.md)
>
> What each provider shares.

> [card] [Environments](https://docs.hoista.dev/guides/environments.md)
>
> Billing is the same in every one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.