Usage

Monitor your current billing period usage, quotas, and API request statistics.

Get Usage Statistics

GET/v1/usage

Returns comprehensive usage information for your organization including audio/video quota, credit balance, and API request statistics.

200 OK

{
  "success": true,
  "data": {
    "period_start": "2026-01-01T00:00:00.000Z",
    "period_end": "2026-02-01T00:00:00.000Z",
    "audio": {
      "quota": 10,
      "used": 7,
      "remaining": 3
    },
    "video": {
      "quota": 5,
      "used": 2,
      "remaining": 3
    },
    "credits": {
      "available": 25,
      "audio_credits": 15,
      "video_credits": 10,
      "expiring_soon": 5
    },
    "api_requests": {
      "today": 45,
      "daily_limit": 500,
      "this_minute": 3,
      "minute_limit": 60
    }
  },
  "request_id": "req_1kn5f2a_a3b4c5d6e7f8",
  "timestamp": "2026-01-18T14:30:00.000Z"
}

Response Fields

Billing Period

Field	Type	Description
`period_start`	string	Start of current billing period (ISO 8601)
`period_end`	string	End of current billing period (ISO 8601)

Audio & Video QuotasVideo Coming Soon

Field	Type	Description
`audio.quota`	integer	Monthly audio episode limit
`audio.used`	integer	Audio episodes used this period
`audio.remaining`	integer	Remaining audio episodes
`video.quota`	integer	Monthly video episode limit
`video.used`	integer	Video episodes used this period
`video.remaining`	integer	Remaining video episodes

Credits

Field	Type	Description
`credits.available`	integer	Total available credits (audio + video)
`credits.audio_credits`	integer	Audio episode credits available
`credits.video_credits`	integer	Video episode credits available (coming soon)
`credits.expiring_soon`	integer	Credits expiring within 30 days

API Requests

Field	Type	Description
`api_requests.today`	integer	API requests made today (UTC)
`api_requests.daily_limit`	integer	Maximum daily requests for your tier
`api_requests.this_minute`	integer	Requests made in the current minute
`api_requests.minute_limit`	integer	Maximum requests per minute for your tier

Rate Limit Headers

All API responses include rate limit and quota information in headers:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 455
X-RateLimit-Reset: 1705622400
X-RateLimit-Limit-Minute: 60
X-RateLimit-Remaining-Minute: 57
X-Quota-Audio-Limit: 10
X-Quota-Audio-Remaining: 3
X-Quota-Video-Limit: 5
X-Quota-Video-Remaining: 3
X-Quota-Reset: 2026-02-01T00:00:00Z
X-Quota-Credits-Available: 25

Header	Description
`X-RateLimit-Limit`	Your daily request limit
`X-RateLimit-Remaining`	Remaining requests today
`X-RateLimit-Reset`	Unix timestamp when daily limit resets
`X-RateLimit-Limit-Minute`	Your per-minute request limit
`X-RateLimit-Remaining-Minute`	Remaining requests this minute
`X-Quota-Audio-Limit`	Monthly audio episode limit
`X-Quota-Audio-Remaining`	Remaining audio episodes
`X-Quota-Video-Limit`	Monthly video episode limit (coming soon)
`X-Quota-Video-Remaining`	Remaining video episodes (coming soon)
`X-Quota-Reset`	ISO 8601 timestamp for quota reset
`X-Quota-Credits-Available`	Available credit balance

PreviousScripts NextWebhooks