---
title: "List usage records"
method: GET
path: "/api/v1/usage/records"
tags: ["Cost Controls"]
---

# List usage records

`GET /api/v1/usage/records`

## Request

- Base URL: `https://orchestrator.getaxonflow.com`
- URL: `https://orchestrator.getaxonflow.com/api/v1/usage/records`
- Auth: none declared. Required headers: `X-Org-ID`
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/docs/api/v1/usage/records/get.ts> (a function with typed inputs; its response is checked against the schema)

List individual usage records with filtering.

Enterprise only. These routes are not registered in Community
edition, which returns 404 Not Found.

## Query parameters

- `start_time` string, date-time
- `end_time` string, date-time
- `provider` string
- `model` string
- `agent_id` string
- `limit` integer
- `offset` integer

## Headers

- `X-Org-ID` string, required

## Response `200`

Usage records

- UsageRecordList
  - `records` UsageRecord[]
    - `id` string
    - `request_id` string
    - `org_id` string
    - `tenant_id` string
    - `team_id` string
    - `agent_id` string
    - `user_id` string
    - `workflow_id` string
    - `provider` string
    - `model` string
    - `tokens_in` integer
    - `tokens_out` integer
    - `cost_usd` number, double
    - `latency_ms` integer
    - `success` boolean
    - `error_message` string
    - `created_at` string, date-time
    - `timestamp` string, date-time: Wall-clock time the usage event occurred — distinct from `created_at` (when the row was inserted). Some downstream paths emit this as the canonical event time.
  - `count` integer
  - `total` integer

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/revisions/f408ef3ec9dd?raw)