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.
/v1/workspaces/{workspaceId}/subscriptions/{connectionId}/usageA 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
The workspace's id, from GET /v1/me.
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"
}