Skip to main content

Get User Usage

GET 
/api/user/usage

Returns usage metrics for the authenticated user over a specified lookback interval, divided into 120 sequential time buckets.

Query Parameters:

  • interval (str, optional): Total lookback window to aggregate usage over. Default is "3h".

    Interval format: an integer value followed by a single unit character. The unit is case-insensitive. Valid units are:

    • m for minutes (e.g., "1m", "30m")
    • h for hours (e.g., "3h")
    • d for days (e.g., "1d", "7d", "30d")

    A valid interval is therefore a positive integer immediately followed by one of m, h, or d (no spaces), such as "30m", "3h", or "7d". Any other format or unit will be rejected.

Request​

Responses​

Successful Response