Usage API

Usage endpoints live under /api/v1/usage.

Important Note

These endpoints expose current quota counters and persisted processing-job analytics where available. They are useful for integrations and diagnostics, but billing and quota enforcement remain the source of truth for invoicing and access decisions.

Endpoints

• GET /api/v1/usage/current
• GET /api/v1/usage/history
• GET /api/v1/usage/analytics
• GET /api/v1/usage/limits

GET /api/v1/usage/current

Returns a current-period payload with:

• current_period
• rate_limits
• endpoint_breakdown
• cost_projection

GET /api/v1/usage/history

Query params:

• start_date
• end_date
• granularity
• limit

Returns:

• periods
• summary
• query_info

GET /api/v1/usage/analytics

Returns persisted-job analytics sections like:

• trends
• patterns
• predictions
• optimization_suggestions
• top_endpoints

GET /api/v1/usage/limits

Returns the current rate-limit view with:

• rate_limits
• warnings
• recommendations

For actual enforced request throttling and plan quotas, use the Rate Limits reference.