ShortyShorty
API Reference

Get plan, limits, and usage

GET
/v1/usage

Returns the authenticated account’s plan (Free / Premium / Pro), tier limits (upload sizes, real-time minutes, conversion caps), and current cloud-conversion usage against the daily quota.

Authorization

BearerApiKey
AuthorizationBearer <token>

A Shorty API key, sent as Authorization: Bearer <key>. An OAuth 2.1 access token issued to a connected app is also accepted on the same header.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/usage"
{  "plan": {    "tier": "free",    "planName": "string"  },  "subscription": {    "isSubscribed": true,    "isProSubscriber": true,    "isOnTrial": true,    "trialEndsAt": "string",    "expiresAt": "string",    "willRenew": true  },  "limits": {    "transcription": {      "maxUploadSizeGb": 0,      "maxUploadSizeLabel": "string",      "realtimeMaxDurationMinutes": 0,      "realtimeMaxDurationLabel": "string"    },    "conversion": {      "maxFileSizeMb": 0,      "maxFileSizeLabel": "string",      "maxBatchItems": 0,      "canUseManagedQueue": true,      "dailyCloudQuota": 0    }  },  "usage": {    "cloudConversionsUsedLast24h": 0,    "cloudConversionsRemaining": 0  }}