メインコンテンツへスキップ
GET
Get Agent Usage

承認

Authorization
string
header
デフォルト:$CARTESIA_ADMIN_API_KEY
必須

Cartesia admin API key (sk_car_admin_...). Get one at play.cartesia.ai/keys/admin.

ヘッダー

Cartesia-Version
enum<string>
デフォルト:2026-03-01
必須

API version header.

利用可能なオプション:
2026-03-01
:

"2026-03-01"

クエリパラメータ

start_ts
string<date-time> | null

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.

:

"2026-03-01T00:00:00Z"

end_ts
string<date-time> | null

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.

:

"2026-03-08T00:00:00Z"

interval
enum<string> | null

Omit to receive a single bucket spanning from start_ts to end_ts. Groups usage data into buckets according to time.

利用可能なオプション:
day,
week,
month

レスポンス

200 - application/json
data
UsageAgentsBucket · object[]
必須

Agent usage buckets in chronological order. Buckets with no recorded activity are returned with zero values.