---
title: "This month's posts, today's AI drafts and brands, against the plan's limits"
method: GET
path: "/api/usage"
---

# This month's posts, today's AI drafts and brands, against the plan's limits

`GET /api/usage`

## Request

- Base URL: `https://postwire.io`
- URL: `https://postwire.io/api/usage`
- Auth: HTTP bearer

{ plan, plan_name, period, posts: { used, limit, left, resets_on }, ai_drafts_today: { used, limit, left, resets_at }, brands: { used, limit }, networks_per_post: { limit }, scheduled_queue: { used, limit, held, left }, grandfathered_until?, upgrade? } — a limit of null means unlimited; upgrade appears at 80 % of a limit.

## Response `200`

usage

---

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