COcontentstudio
📊 Limits & Usage

Get plan limits and current usage

Changed on

Read every metered entitlement for a workspace with what has been used, what the plan allows, and whether it applies — the same figures the billing screen shows for the same workspace. Addons and stackable multipliers are already folded into each limit, so the numbers are the customer's real entitlement rather than their base plan. Read it before a large batch instead of discovering a limit mid-run. The request-rate ceiling is not included — it is published on every response as the standard X-RateLimit-Limit and X-RateLimit-Remaining headers.

get/api/v1/workspaces/{workspace_id}/limits

Request

  • Base URL
    https://api.contentstudio.io
  • URL
    https://api.contentstudio.io/api/v1/workspaces/{workspace_id}/limits
  • Auth
    API key in header X-API-Key

Path parameters

workspace_idstring required
Example:610a1e660cb41530ca40d372

Workspace ID

Response

Limits and usage retrieved

statusboolean
messagestring

Example response

{
  "status": true,
  "message": "Limits and usage retrieved successfully.",
  "data": {
    "plan": {
      "slug": "agency-annual",
      "name": "Business & Agency - Medium (Annually)",
      "is_annually": true,
      "billing_cycle": "annually"
    },
    "limits": [
      {
        "key": "social_accounts",
        "label": "Social Accounts",
        "used": 13,
        "limit": 16,
        "remaining": 3,
        "scope": "account",
        "is_on_plan": true,
        "unit": "count",
        "period": "lifetime",
        "note": "Resets on the 1st of each month; next reset 2026-10-01T00:00:00+00:00."
      }
    ],
    "usage_reset": {
      "last_reset_at": "2026-09-01T00:05:12+00:00",
      "next_reset_at": "2026-10-01T00:00:00+00:00"
    }
  }
}

Changes