usage

Self-service usage, budget, and rate limit status

Changed on

Returns recorded usage, budget statuses, and rate limit statuses for the caller's effective user path (the path bound to the managed API key, or the user-path header for master-key callers).

get/v1/usage

Request

  • Base URL
    http://localhost:8080
  • URL
    http://localhost:8080/v1/usage
  • Auth
    HTTP bearer

Query parameters

start_datestring

Inclusive window start (YYYY-MM-DD, UTC); defaults to 29 days before end_date

end_datestring

Inclusive window end (YYYY-MM-DD, UTC); defaults to today; the whole range may span at most 365 days

daysinteger

Window length ending today when no explicit dates are given (default 30, max 365)

cache_modestring

Which requests to count: uncached (default, provider-bound only), cached (local response-cache hits only), or all

Response

OK

server_timestring
user_pathstring

Changes