Usage API

Usage endpoints live under

/api/v1/usage

Important Note

These endpoints are currently implemented with placeholder/mock analytics data in the backend. They are useful for integration testing and UI wiring, but they are not the billing source of truth for quotas or invoicing.

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 mock analytics sections like:

• trends

• patterns

• predictions

• optimization_suggestions

• top_endpoints

GET /api/v1/usage/limits

Returns a mock rate-limit view with:

• rate_limits

• warnings

• recommendations

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