Sign in

v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB
Usage

Get Agent Usage

Returns your agent usage over time, bucketed by the requested interval.

get/usage/agents

Query parameters

start_tsstring date-time nullable
Example:2026-03-01T00:00:00Z

Start of the time window, as an RFC 3339 datetime (with timezone). Rounded down to the start of the UTC day. start_ts to end_ts cannot span more than a year.

end_tsstring date-time nullable
Example:2026-03-08T00:00:00Z

End of the time window, as an RFC 3339 datetime (with timezone). Rounded up to the start of the next UTC day, unless already at midnight. start_ts to end_ts cannot span more than a year. Must be strictly after start_ts.

interval'day' | 'week' | 'month'

Groups usage data into buckets according to time.

Omit to receive a single bucket spanning from start_ts to end_ts.

Headers

Cartesia-Version'2026-03-01' date required
Example:2026-03-01

API version header.

Response

Example response

{
  "data": [
    {
      "start_ts": "2026-01-01T00:00:00.000Z",
      "end_ts": "2026-01-02T00:00:00.000Z"
    }
  ]
}