---
title: "Get the current managed X posting quota"
method: GET
path: "/api/v1/x-posting/quota"
tags: ["X Posting"]
---

# Get the current managed X posting quota

`GET /api/v1/x-posting/quota`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/x-posting/quota`
- Auth: HTTP bearer

Returns the current workspace-level managed X allowance, usage, remaining posts, and available recurring add-on plans.

## Query parameters

- `workspace_id` string

## Response `200`

X posting quota fetched successfully

- XPostingQuotaResponse
  - `workspace_id` string, required
  - `tier` string, nullable
  - `base_posts` integer, required
  - `addon_posts` integer, required
  - `total_posts` integer, required
  - `used_posts` integer, required
  - `remaining_posts` integer, required
  - `current_period_start` string, date-time, required
  - `current_period_end` string, date-time, required
  - `urls_blocked` boolean, required
  - `addon` XPostingAddonStateResponse, required
    - `active` boolean, required
    - `status` string, required
    - `current_period_end` string, date-time, nullable
    - `cancel_at_period_end` boolean, required
    - `plan_code` string, nullable
    - `monthly_posts` integer, required
  - `plans` XPostingAddonPlanResponse[], required
    - `code` string, required
    - `name` string, required
    - `description` string, required
    - `monthly_posts` integer, required
    - `price_usd` number, required

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `429`: Too many requests

---

[API](https://skmtc.dev/poster/apis/posterly-api.md) · [All operations](https://skmtc.dev/poster/apis/posterly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/poster/apis/posterly-api/revisions/60be02a61f95?raw)