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

# GET /billing/tier

`GET /billing/tier`

## Request

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

## Response `200`

OK

- object: Subscription tier details including pricing and resource limits
  - `tier` 'free' | 'starter' | 'growth' | 'enterprise', required: Current subscription tier identifier
  - `name` string, required: Human-readable name of the subscription tier
  - `price` integer, nullable, required: Monthly price in cents, null for custom-priced tiers
  - `limits` object, required: Resource limits for this tier
    - `messages` integer, nullable, required: Included messages per month. Historically a combined pool; it has been identical to the email quota at every tier for some time and is now sourced from it directly. Kept so existing clients do not break.
    - `agents` integer, nullable, required: Maximum number of agents, null for unlimited
    - `domains` integer, nullable, required: Maximum number of custom domains, null for unlimited
  - `renewalDate` string, date-time, nullable, required: ISO 8601 timestamp of the next billing cycle renewal
  - `billingStatus` 'active' | 'past_due' | 'canceled' | 'cancelled' | 'incomplete' | 'trialing' | 'paused' | 'payment_failed' | 'none', nullable, required: Current subscription status from Stripe, null if no subscription
  - `cancelAtPeriodEnd` boolean, required: Whether the subscription is set to cancel at the end of the current period

---

[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)