---
title: "Datasets Logs List"
method: GET
path: "/evaluations/datasets/{dataset_id}/logs/"
tags: ["evaluations"]
---

# Datasets Logs List

`GET /evaluations/datasets/{dataset_id}/logs/`

Import existing logs into dataset based on filter criteria

Endpoints:
    POST   /evaluations/datasets/{dataset_id}/logs/ - Import existing logs to dataset asynchronously (legacy)
    POST   /api/datasets/{dataset_id}/logs/import/ - Import existing logs to dataset asynchronously
    DELETE /api/datasets/{dataset_id}/logs/import/ - Remove logs from dataset asynchronously

Args (POST body):
    - start_time (string, required, ISO 8601)
    - end_time (string, required, ISO 8601)
    - filters (object, optional; key name is "filters")
    - sampling_percentage (integer, optional, default 100)

Returns (POST 200):
    { "message": "Logs are being imported to dataset in the background" }

Args (DELETE body):
    - is_deleting_all_logs (boolean, required if filters not provided)
    - filters (object, required unless is_deleting_all_logs = true)

Returns (DELETE 200):
    { "message": "Logs are being removed from dataset in the background" }

Access Control:
    NestedResourceMixin handles superadmin-aware parent access:
    - Superadmin + JWT + READ: Can view any dataset's logs
    - Superadmin + JWT + WRITE: Blocked (can't import/delete logs in other orgs via JWT)
    - Superadmin + API key: Can import/delete logs in any dataset
    - Regular user: Can only access their org's datasets

## Path parameters

- `dataset_id` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

- PaginatedCHDatasetLogList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `total_count` integer
  - `current_filters` FilterParamDictPydantic — Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters. Each key is a metric name (str), and each value can be: - A single MetricFilterParamPydantic (one condition) - A List[MetricFilterParamPydantic] (multiple conditions for same metric) - A FilterBundlePydantic (nested filter bundle with connector) Note: Uses extra="allow" for dynamic metric name fields. The __pydantic_extra__ annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.
  - `filters_data` PaginatedChDatasetLogListFiltersData
  - `results` CHDatasetLog[], required
    - `id` string, required
    - `input_words` string, required
    - `output_words` string, required
    - `input_chars` string, required
    - `output_chars` string, required
    - `organization_key_name` string, required
    - `organization_id` string, required
    - `unique_organization_id` string
    - `organization_name` string
    - `error_message` string
    - `warnings` string, required
    - `annotation_status` string, required
    - `keywordsai_params` string, required
    - `full_request` string, required
    - `full_response` string, required
    - `metadata` string, required
    - `tools` string, required
    - `tool_calls` string, required
    - `prompt_messages` string, required
    - `completion_message` string, required
    - `completion_messages` unknown
    - `input` string
    - `output` string
    - `variables` unknown
    - `temperature` number, double
    - `max_tokens` integer
    - `top_p` number, double
    - `frequency_penalty` number, double
    - `presence_penalty` number, double
    - `stop` string
    - `response_format` unknown
    - `matched_meter_ids` unknown[]
      - unknown
    - `unit_prices` object
    - `component_costs` object
    - `dataset_id` string
    - `original_copy_unique_id` string
    - `comparison_key` string
    - `expected_output` string
    - `custom_identifier` string
    - `group_identifier` string
    - `blurred` boolean
    - `start_time` string, date-time
    - `timestamp` string, date-time
    - `load_balance_group_id` string
    - `prompt_tokens` integer
    - `completion_tokens` integer
    - `prompt_cache_hit_tokens` integer
    - `prompt_cache_creation_tokens` integer
    - `reasoning_tokens` integer
    - `total_request_tokens` integer
    - `is_token_count_estimated` integer
    - `cost` number, double
    - `llm_gateway_markup_rate` number, double
    - `service_tier` string
    - `model_discount` number, double
    - `pricing_tier` string
    - `audio_input_file` string
    - `audio_output_file` string
    - `organization_key_id` string
    - `user_email` string
    - `model` string
    - `provider_id` string
    - `category` string
    - `properties` string
    - `cache_bit` integer
    - `cache_miss_bit` integer
    - `cache_key` string
    - `latency` number, double
    - `tokens_per_second` number, double
    - `time_to_first_token` number, double
    - `routing_time` number, double
    - `status` string
    - `has_tool_calls` boolean
    - `status_code` integer
    - `log_method` string
    - `log_type` string
    - `environment` string
    - `stream` boolean
    - `evaluation_identifier` string
    - `customer_identifier` string
    - `customer_email` string
    - `customer_name` string
    - `customer_user_unique_id` string
    - `used_custom_credential` boolean
    - `deployment_name` string
    - `deployment_id` string
    - `prompt_name` string
    - `prompt_id` string
    - `prompt_version_number` integer
    - `system_text` string
    - `prompt_text` string
    - `completion_text` string
    - `prompt_message_count` integer
    - `completion_message_count` integer
    - `trace_unique_id` string
    - `span_unique_id` string
    - `span_name` string
    - `span_parent_id` string
    - `span_workflow_name` string
    - `session_identifier` string
    - `span_links` string
    - `trace_group_identifier` string
    - `thread_identifier` string
    - `thread_unique_id` string
    - `storage_object_key` string
    - `period_start` string, date-time
    - `period_end` string, date-time
    - `unique_id` string
    - `respan_gateway_request_id` string
    - `full_text` string

---

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