---
title: "Get paginated usage log entries"
method: GET
path: "/admin/usage/log"
tags: ["admin"]
---

# Get paginated usage log entries

`GET /admin/usage/log`

## Query parameters

- `days` integer
- `start_date` string
- `end_date` string
- `model` string
- `provider` string
- `label` string
- `user_path` string
- `cache_mode` string
- `session_id` string
- `search` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- UsageUsageLogResult
  - `entries` UsageUsageLogEntry[]
    - `cache_type` string
    - `cache_write_input_tokens` integer
    - `cached_input_ratio` number
    - `cached_input_tokens` integer
    - `cost_source` string
    - `costs_calculation_caveat` string
    - `endpoint` string
    - `id` string
    - `input_cost` number
    - `input_tokens` integer
    - `labels` string[]
    - `model` string
    - `output_cost` number
    - `output_tokens` integer
    - `provider` string
    - `provider_id` string
    - `provider_name` string
    - `raw_data` object
    - `request_id` string
    - `rewrite_cost_saved` number
    - `rewrite_tokens_saved` integer
    - `session_id` string
    - `timestamp` string
    - `total_cost` number
    - `total_tokens` integer
    - `uncached_input_tokens` integer
    - `user_path` string
  - `limit` integer
  - `offset` integer
  - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

> 53 revisions in range; 5 could not be searched.

- **2026-08-15** `20b764f8e750` — 2 info
  - added the new optional `query` request parameter `session_id`
  - added the optional property `entries/items/session_id` to the response with the `200` status
- **2026-07-08** `c658d104b32e` — 2 info
  - added the optional property `entries/items/rewrite_cost_saved` to the response with the `200` status
  - added the optional property `entries/items/rewrite_tokens_saved` to the response with the `200` status
- **2026-07-04** `b559d13a3057` — 2 info
  - added the new optional `query` request parameter `label`
  - added the optional property `entries/items/labels` to the response with the `200` status
- **2026-05-22** `4473702da82e` — 4 info
  - added the optional property `entries/items/cache_write_input_tokens` to the response with the `200` status
  - added the optional property `entries/items/cached_input_ratio` to the response with the `200` status
  - added the optional property `entries/items/cached_input_tokens` to the response with the `200` status
  - added the optional property `entries/items/uncached_input_tokens` to the response with the `200` status
- **2026-05-09** `1236749560f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/admin/usage/log/get.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/7b5727a74f59/schema)