> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Export Usage (CSV)

> Download your billed usage as a CSV file.

Returns your billed line items (credit debits) as a CSV attachment.

## Authentication

Requires an API key with `billing` scope.

## Query Parameters

<ParamField query="from" type="string">
  ISO timestamp lower bound (inclusive).
</ParamField>

<ParamField query="to" type="string">
  ISO timestamp upper bound (inclusive).
</ParamField>

## 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

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