# https://compresr.ai/docs/api-reference/billing-tiers

> Human-readable page: https://compresr.ai/docs/api-reference/billing-tiers

`GET /api/billing/tiers`

Public, unauthenticated endpoint. Returns the same tier schedule that drives the pricing page and the live [`TierTable`](/docs/api-reference/rate-limits) component. Most readers want [Rate limits & headers](/docs/api-reference/rate-limits); this page documents the raw shape.

## Response

| Field | Type | Description |
| --- | --- | --- |
| `success` | boolean | Always true on 200. |
| `tiers` | array | Ordered list of tiers, lowest to highest. |
| `tiers.name` | string | Stable tier identifier: tier1, tier2, tier3, tier4, tier5. |
| `tiers.display_name` | string | Human-readable name (e.g. "Free", "Starter"). |
| `tiers.min_monthly_tokens` | integer | Minimum monthly compressed tokens to reach this tier. |
| `tiers.max_api_keys` | integer | Maximum number of API keys the tier permits. |
| `tiers.rate_limits` | object |  |
| `tiers.rate_limits.rpm` | integer | Requests per minute. -1 means unlimited. |
| `tiers.rate_limits.tpm` | integer | Tokens per minute. -1 means unlimited. |
| `tiers.rate_limits.rpd` | integer | Requests per day. -1 means unlimited. |

## Status codes

| Status | Description |
| --- | --- |
| 200 | Tiers returned. |
| 500 | Internal error fetching the tier schedule. |

```python
import httpx

response = httpx.get("https://api.compresr.ai/api/billing/tiers", timeout=10)
response.raise_for_status()

for tier in response.json()["tiers"]:
    limits = tier["rate_limits"]
    print(
        f"{tier['display_name']:<12} "
        f"rpm={limits['rpm']:>6} tpm={limits['tpm']:>10} rpd={limits['rpd']:>8}"
    )
```

**TypeScript**

```typescript
const response = await fetch('https://api.compresr.ai/api/billing/tiers');
if (!response.ok) {
  throw new Error(`Failed to load tiers: ${response.status}`);
}

const { tiers } = await response.json();
for (const tier of tiers) {
  const { rpm, tpm, rpd } = tier.rate_limits;
  console.log(`${tier.display_name}  rpm=${rpm} tpm=${tpm} rpd=${rpd}`);
}
```

**cURL**

```bash
curl https://api.compresr.ai/api/billing/tiers
```

  response={

```json
{
  "success": true,
  "tiers": [
    {
      "name": "tier1",
      "display_name": "Free",
      "min_monthly_tokens": 0,
      "max_api_keys": 1,
      "rate_limits": { "rpm": 30, "tpm": 200000, "rpd": 1000 }
    },
    {
      "name": "tier2",
      "display_name": "Starter",
      "min_monthly_tokens": 1000000,
      "max_api_keys": 3,
      "rate_limits": { "rpm": 120, "tpm": 1000000, "rpd": 20000 }
    }
  ]
}
```