Sinatra Docs
API ReferenceSubscriptions

Get subscription usage

Acts only on your own subscriptions in this workspace, not another member's.

Use a personal API token or an OAuth access token issued for the REST API; MCP-audience tokens are rejected. Fetches live usage for the connection's provider. Codex and Claude report cap windows, xAI reports allowances and products, and Cursor reports labeled windows. Provider-omitted values remain absent.

GET/v1/workspaces/{workspaceId}/subscriptions/{connectionId}/usage
AuthorizationBearer <token>

A personal access token, which starts with sntr_. Create one on the dashboard's CLI & API page (https://app.sinatra.dev/tokens). It acts as you in every workspace you belong to, with your role in each, and expires after at most 365 days. The CLI's browser sign-in sends an OAuth access token here instead.

In: header

Path Parameters

workspaceIdstring

The workspace's id, from GET /v1/me.

connectionIdstring

Your subscription connection's id, from GET /v1/workspaces/{workspaceId}/subscriptions.

Response Body

curl -X GET "https://api.sinatra.dev/v1/workspaces/string/subscriptions/string/usage"
{
  "fetchedAt": "string",
  "plan": "string",
  "fiveHour": {
    "usedPercent": 0,
    "leftPercent": 0,
    "resetsAt": "string",
    "windowSeconds": 0
  },
  "weekly": {
    "usedPercent": 0,
    "leftPercent": 0,
    "resetsAt": "string",
    "windowSeconds": 0
  },
  "resetCredits": {
    "availableCount": 0,
    "credits": [
      {
        "id": "string",
        "status": "string",
        "grantedAt": "string",
        "expiresAt": "string",
        "title": "string"
      }
    ]
  }
}
{
  "error": "string",
  "reason": "string",
  "requestId": "string",
  "refusal": "string",
  "billingUrl": "string",
  "settingsUrl": "string",
  "plan": "string",
  "running": 0,
  "queued": 0,
  "taskId": "string",
  "messageId": "string"
}
{
  "error": "string",
  "reason": "string",
  "requestId": "string",
  "refusal": "string",
  "billingUrl": "string",
  "settingsUrl": "string",
  "plan": "string",
  "running": 0,
  "queued": 0,
  "taskId": "string",
  "messageId": "string"
}
{
  "error": "string",
  "reason": "string",
  "requestId": "string",
  "refusal": "string",
  "billingUrl": "string",
  "settingsUrl": "string",
  "plan": "string",
  "running": 0,
  "queued": 0,
  "taskId": "string",
  "messageId": "string"
}
{
  "error": "string",
  "reason": "string",
  "requestId": "string",
  "refusal": "string",
  "billingUrl": "string",
  "settingsUrl": "string",
  "plan": "string",
  "running": 0,
  "queued": 0,
  "taskId": "string",
  "messageId": "string"
}
{
  "error": "string",
  "reason": "string",
  "requestId": "string",
  "refusal": "string",
  "billingUrl": "string",
  "settingsUrl": "string",
  "plan": "string",
  "running": 0,
  "queued": 0,
  "taskId": "string",
  "messageId": "string"
}