---
title: "List log scores"
method: GET
path: "/api/logs/{log_id}/scores/"
tags: ["scores"]
---

# List log scores

`GET /api/logs/{log_id}/scores/`

List all scores for a specific log/span.

## Path parameters

- `log_id` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

Paginated list of scores for this log/span.

- ScoresListSpanScoresResponse200
  - `count` integer, required — Number of scores returned on this page.
  - `next` string, nullable — URL for the next page, if any.
  - `previous` string, nullable — URL for the previous page, if any.
  - `current_filters` ApiLogsLogIdScoresGetResponsesContentApplicationJsonSchemaCurrentFilters — Normalized filters applied to this request.
  - `results` ApiLogsLogIdScoresGetResponsesContentApplicationJsonSchemaResultsItems[], required
    - `id` string, required — Score ID.
    - `created_at` string, date-time, required — When the score was created.
    - `type` 'llm' | 'human' | 'code' | 'function' | 'human_numerical' | 'human_boolean' | 'human_categorical' | 'human_text' | 'custom' — Evaluator execution type. Legacy rows may contain legacy type values.
    - `environment` string — Environment associated with the score.
    - `numerical_value` number, double, nullable — Numeric score value. Use for `numerical` and `percentage` evaluators.
    - `string_value` string, nullable — Text score value. Use for `text` and legacy `comment` evaluators.
    - `boolean_value` boolean, nullable — Boolean score value. Use for `boolean` evaluators.
    - `categorical_value` string[], nullable — Categorical score values. Use for `single_select`, `multi_select`, and legacy `categorical` evaluators.
    - `json_value` string, nullable — JSON score value encoded as a string. Use for `json` evaluators.
    - `is_passed` boolean, nullable — Whether the score passes the evaluator conditions.
    - `cost` number, double, nullable — Evaluation cost in USD, when available.
    - `evaluator_id` string, nullable — Evaluator ID associated with the score.
    - `evaluator_slug` string, nullable — Evaluator slug associated with the score.
    - `evaluator_name` string, nullable — Human-readable evaluator name, when available.
    - `scorer` string, nullable — Who or what produced the score. For log-scoped score writes, the backend derives this from the authenticated user.
    - `log_id` string, nullable — Associated log/span ID.
    - `prompt_id` string, nullable — Associated prompt ID, when available.
    - `prompt_version_number` integer, nullable — Associated prompt version number, when available.
    - `dataset_id` string, nullable — Associated dataset ID, when available.
    - `automation_id` string, nullable — Associated automation ID, when available.
    - `status` string, nullable — Evaluation status, when available.
    - `error_message` string, nullable — Evaluation error message, when available.
    - `explanation` string — Optional explanation for the score.

## Other responses

- `401` — Unauthorized - Missing or invalid authentication
- `404` — Not Found

## Changes

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

- **2026-07-31** `c26d550029f8` — 2 breaking, 5 warning, 4 info
  - the `next` response's property type/format changed from `string, null`/`` to `string, null`/`uri` for status `200`
  - the `previous` response's property type/format changed from `string, null`/`` to `string, null`/`uri` for status `200`
  - removed the optional property `results/items/automation_id` from the response with the `200` status
  - removed the optional property `results/items/evaluator_name` from the response with the `200` status
  - …7 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/logs/:log_id/scores/get.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)