These endpoints let you track how much of your plan you’ve used and how much capacity you have right now.
Get Usage Return request and document counts for the current API key, both for the current calendar month and all-time.
Endpoint GET /api/v1/usageCounters in this response have two scopes. Per-key: requests, ingests, queries reflect just what this API key has done. Per-workspace: pages, audio_seconds, and documents_stored reflect the workspace the key belongs to (across all keys and in-app activity).
Response Requests made this calendar month
Documents ingested this calendar month
Queries made this calendar month
Show Pages-processed counters
Pages processed this calendar month (workspace-wide)
All-time pages processed (workspace-wide)
Show Audio-seconds counters
Seconds of audio processed this calendar month (workspace-wide)
All-time audio seconds processed (workspace-wide)
Number of documents currently in your workspace
Example curl "https://app.polyvia.ai/api/v1/usage" \ -H "Authorization: Bearer poly_<your-key>"
{ "usage" : { "requests" : { "period" : 142 , "total" : 3801 }, "ingests" : { "period" : 12 , "total" : 204 }, "queries" : { "period" : 130 , "total" : 3597 }, "pages" : { "period" : 318 , "total" : 5421 }, "audio_seconds" : { "period" : 1840 , "total" : 34920 }, "documents_stored" : 47 } }
Get Rate Limits Return the rate-limit thresholds for your plan and how much capacity remains right now.
Endpoint GET /api/v1/rate-limitsResponse Hard limits for your plan (requests per minute, per month, etc.)
Real-time headroom — how much capacity remains in each window.
ISO 8601 timestamps of when each counter resets. When the per-minute window resets
When the monthly counters reset (first day of next month)
Example curl "https://app.polyvia.ai/api/v1/rate-limits" \ -H "Authorization: Bearer poly_<your-key>"
{ "limits" : { "requests_per_minute" : 60 , "requests_per_month" : 10000 , "documents_per_month" : 500 , "queries_per_month" : 2000 }, "current" : { "remaining_this_minute" : 58 , "remaining_requests_this_month" : 9858 , "remaining_documents_this_month" : 488 , "remaining_queries_this_month" : 1870 }, "resets_at" : { "minute" : "2025-04-23T14:32:00Z" , "month" : "2025-05-01T00:00:00Z" } }
Rate limits are informational — the API does not block requests when limits are reached, but you should monitor these values and implement back-off logic in production integrations.
