> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "List scores"
description: "List individual scorer results across runs, for building custom dashboards."
method: "GET"
endpoint: "/api/v1/projects/:projectId/eval/scores"
order: 15
group: "Analyze a run"
last_verified: 2026-07-27
---

<ApiEndpoint method="GET" endpoint="/api/v1/projects/:projectId/eval/scores" description="List individual scorer results across runs, for building custom dashboards.">
  <section>
    #### Query parameters
    <ApiAttribute name="experiment_run_id" type="string" description="Filter to a single experiment run. Alias: run_id." required={false} />
    <ApiAttribute name="experiment_run_item_id" type="string" description="Filter to a single run item. Alias: run_item_id." required={false} />
    <ApiAttribute name="subject_type" type="string" description="Filter by what was scored, e.g. experiment_run_item, trace, or production_run." required={false} />
    <ApiAttribute name="subject_id" type="string" description="Filter to a single subject, paired with subject_type." required={false} />
    <ApiAttribute name="scorer_id" type="string" description="Filter to a single scorer's UUID." required={false} />
    <ApiAttribute name="deployment_id" type="string" description="Filter to a single deployment." required={false} />
    <ApiAttribute name="created_after" type="string" description="Only scores created after this time, as RFC 3339 or epoch seconds/milliseconds. Alias: since." required={false} />
    <ApiAttribute name="created_before" type="string" description="Only scores created before this time, as RFC 3339 or epoch seconds/milliseconds. Alias: until." required={false} />
    <ApiAttribute name="page" type="integer" description="Page number. Defaults to 1." required={false} />
    <ApiAttribute name="page_size" type="integer" description="Results per page. Defaults to 50." required={false} />
  </section>

  <Callout type="info">
There's no way to filter scores by an experiment's own ID directly — filter by `experiment_run_id` (a specific run of that experiment) instead. List an experiment's runs first via [List runs](#list-runs).
  </Callout>
</ApiEndpoint>