---
title: "List dataset logs"
method: POST
path: "/api/datasets/{dataset_id}/logs/list/"
tags: ["datasets"]
---

# List dataset logs

`POST /api/datasets/{dataset_id}/logs/list/`

List logs in a dataset with filters and pagination. Set `is_exporting=true` to trigger an asynchronous CSV or JSONL export instead of returning results.

## Path parameters

- `dataset_id` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `sort_by` string
- `include_fields` string

## Headers

- `Authorization` string, required

## Request body

- object
  - `filters` object — Platform-standard filters keyed by field name.
  - `is_exporting` boolean — Set to `true` to export logs instead of returning a paginated list.
  - `export_format` '.csv' | '.jsonl' — Export format. Defaults to `.csv`.
  - `name` string — Optional export file name.

## Response `200`

Paginated dataset logs, or an export acknowledgement when `is_exporting=true`.

- union
  - DatasetsListDatasetLogsResponse2000
    - `count` integer, required — Total matching logs.
    - `next` string, nullable — Next page URL.
    - `previous` string, nullable — Previous page URL.
    - `results` ApiDatasetsDatasetIdLogsListPostResponsesContentApplicationJsonSchemaOneOf0ResultsItems[], required — Array of dataset log objects.
      - `id` string
      - `unique_id` string
      - `organization_id` string
      - `environment` string
      - `timestamp` string, date-time
      - `start_time` string, date-time
      - `prompt_tokens` integer
      - `completion_tokens` integer
      - `total_request_tokens` integer
      - `cost` number, double
      - `model` string
      - `latency` number, double
      - `status_code` integer
      - `status` string
      - `prompt` string
      - `completion` string
      - `input` unknown
      - `output` unknown
      - `dataset_id` string
      - `annotation_status` string
      - `annotation_completed_by` ApiDatasetsDatasetIdLogsListPostResponsesContentApplicationJsonSchemaOneOf0ResultsItemsAnnotationCompletedBy
        - `first_name` string
        - `last_name` string
        - `email` string, email
      - `scores` object
      - `metadata` ApiDatasetsDatasetIdLogsListPostResponsesContentApplicationJsonSchemaOneOf0ResultsItemsMetadata
      - `custom_identifier` string
      - `log_type` string
    - `total_count` integer — Total matching logs.
    - `current_filters` object — Platform-standard filters keyed by field name.
    - `filters_data` ApiDatasetsDatasetIdLogsListPostResponsesContentApplicationJsonSchemaOneOf0FiltersData
    - `filter_options` ApiDatasetsDatasetIdLogsListPostResponsesContentApplicationJsonSchemaOneOf0FilterOptions
  - DatasetsListDatasetLogsResponse2001
    - `message` string, required

## Other responses

- `401` — Unauthorized - Missing/invalid authentication

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c26d550029f8` — 4 breaking, 7 warning, 2 info
  - for the `query` request parameter `page`, default value `1` was removed
  - for the `query` request parameter `page_size`, default value `25` was removed
  - the `filters/additionalProperties/` request property type/format changed from `object`/`` to ``/``
  - removed the success response with the status `200`
  - …9 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/datasets/:dataset_id/logs/list/post.md)

---

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