---
title: "Get a list of usage records for a given period"
method: GET
path: "/v1/usage/records"
tags: ["Usage"]
---

# Get a list of usage records for a given period

`GET /v1/usage/records`

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `page` integer
- `items_per_page` integer

## Response `200`

Usage records retrieved successfully

- object
  - `data` UsageRecordResponse[]
    - `id` string, uuid
    - `created_at` string, date-time
    - `service_name` 'FINE_TUNING_JOB'
    - `usage_amount` number, float
    - `usage_unit` 'TOKEN'
    - `cost` number, float
    - `fine_tuning_job_name` string
  - `pagination` Pagination
    - `total_pages` integer
    - `current_page` integer
    - `items_per_page` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized

## Changes

- **2024-10-01** `9129e0f56c77` — 1 warning, 1 info
  - added the new `FINE_TUNING_JOB` enum value to the `data/items/service_name` response property for the response status `200`
  - added the optional property `data/items/usage_unit` to the response with the `200` status

[Change history](https://skmtc.dev/luminolabs/apis/usage-api/changes/v1/usage/records/get.md)

---

[API](https://skmtc.dev/luminolabs/apis/usage-api.md) · [All operations](https://skmtc.dev/luminolabs/apis/usage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/luminolabs/usage-api/revisions/9129e0f56c77/schema)