Skip to main content
GET
/
api
/
v1
/
usage
/
export
Export Usage (CSV)
curl --request GET \
  --url https://api.example.com/api/v1/usage/export
Returns your billed line items (credit debits) as a CSV attachment.

Authentication

Requires an API key with billing scope.

Query Parameters

from
string
ISO timestamp lower bound (inclusive).
to
string
ISO timestamp upper bound (inclusive).

Response

Content-Type: text/csv attachment. Columns:
date,description,model,amount_usd
Each row is a single billed call; amount_usd is the charged amount for that call.

Example

curl
curl -L "https://www.hitheo.ai/api/v1/usage/export?from=2026-05-01" \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -o theo-usage.csv