latestOpenAPI 3.1.02026-08-14141637.4 KB

7d245a8d7a75

Usage

Export daily aggregates as CSV or JSON

Returns a downloadable file (CSV uses RFC-4180 quoting; JSON is a flat array — no envelope). The format query selects the content type. When projectId is set, every row carries that project's name in the project_name column. Supply startDate + endDate (YYYY-MM-DD, together, max 366 days) for a custom period; the filename then reflects those bounds instead of the preset.

get/api/v1/usage/export

Query parameters

range'7d' | '30d' | '90d' | '365d'
startDatestring
endDatestring
format'csv' | 'json'
projectIdstring uuid

Response

Exported file (CSV or JSON depending on format param)

datestring required
project_namestring required
prompt_tokensnumber required
completion_tokensnumber required
total_tokensnumber required
request_countnumber required
cost_usdnumber required
carbon_kgnumber required
energy_kwhnumber required