X Posting

Get the current managed X posting quota

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

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

Query parameters

workspace_idstring

Optional workspace to inspect. Defaults to the caller’s personal workspace billing context.

Response

X posting quota fetched successfully

workspace_idstring required
tierstring nullable
base_postsinteger required
addon_postsinteger required
total_postsinteger required
used_postsinteger required
remaining_postsinteger required
current_period_startstring date-time required
current_period_endstring date-time required
urls_blockedboolean required

Example response

{
  "workspace_id": "2d0a6d4c-9eef-4ee2-9026-2ca0dc29c8d6",
  "tier": "pro",
  "base_posts": 25,
  "addon_posts": 100,
  "total_posts": 125,
  "used_posts": 12,
  "remaining_posts": 113,
  "current_period_start": "2026-04-01T00:00:00.000Z",
  "current_period_end": "2026-05-01T00:00:00.000Z",
  "urls_blocked": true,
  "addon": {
    "active": true,
    "status": "active",
    "current_period_end": "2026-05-01T00:00:00.000Z",
    "cancel_at_period_end": false,
    "plan_code": "x_posts_100",
    "monthly_posts": 100
  },
  "plans": [
    {
      "code": "x_posts_100",
      "name": "+100 X posts / month",
      "description": "Recurring monthly add-on for higher-volume X posting without URLs.",
      "monthly_posts": 100,
      "price_usd": 8
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.