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

# Billing API

> List public Squasher billing plans for agent and CLI workflows.

Use the Billing API when a script or agent needs the current public plan catalog.

## Operations

| Operation           | Method and path         | Purpose                       |
| ------------------- | ----------------------- | ----------------------------- |
| `billing.listPlans` | `GET /v1/billing/plans` | List available billing plans. |

This endpoint does not require project scope. It returns the plan catalog; account-specific billing actions remain separate from this public API surface.

Plans include a `retention_days_by_feature` object because error history, logs,
traces, metrics, replays, and AI observations can have different retention
windows.

## CLI and MCP

Use `squasher billing plans` for terminal workflows. In MCP Code Mode, call `search("billing")` before executing.

## Agent handoff

```text theme={null}
Fetch Squasher billing plans using billing.listPlans. Summarize plan names, limits, and public pricing fields exactly as returned. Do not infer account-specific entitlement or billing state from the catalog alone.
```

Related: [Plans and billing](/features/plans-and-billing).