---
title: "List logs"
method: GET
path: "/v1/workspaces/{workspaceID}/logs"
tags: ["Logs"]
---

# List logs

`GET /v1/workspaces/{workspaceID}/logs`

Lists paginated request logs for a workspace. Date range is constrained by the
workspace plan's log retention period.

For image operations, both generations and edits are included when filtering by image routes.

## Path parameters

- `workspaceID` string, required

## Query parameters

- `from` string, date
- `to` string, date
- `model` string
- `url` '/chat/completions' | '/embeddings' | '/image/generations' | '/image/edits'
- `page` integer
- `count` integer
- `key` string

## Response `200`

Paginated list of logs

- LogListResponse
  - `logs` LogEntry[]
    - `_id` string
    - `type` 'ERROR_VALIDATION' | 'PROVIDER_RESPONSE' | 'ERROR_PROVIDER'
    - `content` object
      - `model` string
      - `key` string — API key name
      - `details` object
        - `tokens_prompt` integer
        - `tokens_completion` integer
        - `total_cost_toman` number
    - `workspace` string
    - `method` string
    - `url` string
    - `createdAt` string, date-time
  - `count` integer — Total number of matching logs

## Other responses

- `401` — Missing authentication
- `404` — Workspace not found
- `416` — Date range exceeds plan retention

---

[API](https://skmtc.net/liara-cloud/apis/ai-logs.md) · [All operations](https://skmtc.net/liara-cloud/apis/ai-logs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liara-cloud/ai-logs/revisions/982815fba992/schema)