---
title: "GET /billing/plans"
method: GET
path: "/billing/plans"
---

# GET /billing/plans

`GET /billing/plans`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/billing/plans`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Response `200`

OK

- object: Canonical tier catalog for the billing comparison grid, derived from TIERS
  - `plans` object[], required: Public plan catalog in ascending upgrade order
    - `tier` 'free' | 'starter' | 'growth' | 'enterprise', required: Publicly-selectable billing tier; sunset 'scale' is excluded
    - `name` string, required: Human-readable name of the tier
    - `price` integer, nullable, required: Monthly price in cents, null for custom-priced tiers
    - `priceAnnual` integer, nullable, required: Total charged once a year, in cents. null means the tier has no annual SKU (Free, Enterprise) — render the monthly price and hide the annual option.
    - `limits` object, required: Included quotas / caps for a tier, projected from the canonical TIERS table
      - `emails` integer, nullable, required: Included emails sent per month, null=unlimited
      - `smsSent` integer, nullable, required: Included SMS sent per month, null=unlimited
      - `smsReceived` integer, nullable, required: Included SMS received per month, null=unlimited
      - `agents` integer, nullable, required: Maximum agents, null=unlimited
      - `domains` integer, nullable, required: Maximum custom domains, null=unlimited
      - `identities` integer, nullable, required: Maximum agent identities, null=unlimited
      - `phoneNumbers` integer, nullable, required: Included phone numbers, null=unlimited
      - `credentials` integer, nullable, required: Maximum vault credentials, null=unlimited
      - `voiceMinutes` integer, nullable, required: Included voice minutes per month, null=unlimited
      - `storageBytes` integer, nullable, required: Included object storage in BYTES (not GB), null=unlimited

---

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