---
title: "Get Agent Usage"
method: GET
path: "/usage/agents"
tags: ["Usage"]
---

# Get Agent Usage

`GET /usage/agents`

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

## Query parameters

- `start_ts` string, date-time, nullable
- `end_ts` string, date-time, nullable
- `interval` 'day' | 'week' | 'month' — Groups usage data into buckets according to time.

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- UsageAgentsResponse
  - `data` UsageAgentsBucket[], required — Agent usage buckets in chronological order. Buckets with no recorded activity are returned with zero values.
    - `start_ts` string, date-time, required — RFC 3339 timestamp for the start of the usage bucket.
    - `end_ts` string, date-time, required — RFC 3339 timestamp for the end of the usage bucket.
    - `cents` integer, required — Total cost in US cents accrued within the bucket.
    - `minutes` number, required — Total minutes of agent runtime within the bucket.
    - `calls` integer, required — Number of agent calls that started within the bucket.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/revisions/8910812440d3/schema)