---
title: "Export a usage report as CSV"
method: GET
path: "/credits/usage/export/"
tags: ["credits"]
---

# Export a usage report as CSV

`GET /credits/usage/export/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/credits/usage/export/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

One endpoint serves every report; filters mirror the source endpoints. Streams synchronously; the ledger export reads in keyset batches.

## Query parameters

- `report` 'balance_timeseries' | 'spend_timeseries' | 'by_table' | 'by_provider' | 'by_agent' | 'table_timeseries' | 'table_by_column' | 'table_by_run' | 'ledger', required: Which usage report a CSV export serves.
- `start_time` string, date-time, required: Range start (ISO 8601)
- `end_time` string, date-time, required: Range end (ISO 8601)
- `interval` 'hour' | 'day'
- `timezone` string: IANA timezone for buckets
- `table_id` string, uuid, nullable
- `entry_kind` 'grant' | 'expiry' | 'pack_purchase' | 'charge' | 'refund' | 'referral' | 'adjustment': The kind of a credit ledger entry.

## Response `200`

The report as a CSV file.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Table not found
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)