---
title: "Get current monthly plan allowances"
method: GET
path: "/api/v1/billing/allowances"
tags: ["billing"]
---

# Get current monthly plan allowances

`GET /api/v1/billing/allowances`

## Request

- Base URL: `https://api.cadencz.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cadencz.com/api/v1/billing/allowances`
- Auth: HTTP bearer

## Response `200`

Successful Response

- PlanAllowanceRead
  - `tier` string, required
  - `period_start` string, required
  - `premium_actions_used` integer, required
  - `premium_actions_cap` integer, required
  - `plan_runs_used` integer, required
  - `plan_runs_cap` integer, required
  - `posts_per_plan_cap` integer, required
  - `weekly_posts_used` integer
  - `weekly_posts_cap` integer
  - `weekly_posts_per_write` integer
  - `week_resets_at` string, nullable
  - `x_weekly_posts_used` integer
  - `x_weekly_posts_cap` integer, nullable
  - `total_ai_generations_used` integer, required
  - `total_ai_generations_cap` integer, required
  - `brain_refreshes_used` integer
  - `brain_refreshes_cap` integer
  - `brain_refreshes_monthly` boolean
  - `ai_analytics_insights_used` integer, required
  - `ai_analytics_insights_cap` integer, required
  - `x_posts_cap` integer, required
  - `non_x_scheduled_posts_cap` integer, nullable, required
  - `channel_cap` integer, required
  - `x_account_cap` integer, required
  - `platform_account_caps` object
  - `seat_cap` integer, required
  - `automation_rule_cap` integer, required

## Other responses

- `401`: Missing or invalid Supabase bearer token.

---

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