---
search:
  tags:
    - V1
    - POST
seo:
  description: >-
    Request evaluation of specific stored traces with current… Reference for the
    POST /v1/projects/{projectId}/traces/evaluate endpoint in the Judgeval API.
sidebar:
  label: Evaluate stored traces
  badge: POST
title: Evaluate stored traces
type: openapi-operation
---
Request evaluation of specific stored traces with current production judges, optionally restricted to named judges. Evaluation is asynchronous and costs JUs. Each judge type is checked against its own usage limit; the response lists admitted and skipped judges per trace and any unknown trace IDs or judge names.

`POST /v1/projects/{projectId}/traces/evaluate`

**Request body** (`application/json`, required)

- `trace_ids` (string[], required) — Trace IDs to evaluate
- `judge_names` (string[]) — Restrict evaluation to these judge names

Request body example:

```json
{
  "trace_ids": [
    "string"
  ],
  "judge_names": [
    "string"
  ]
}
```

**Responses**

- `200` — Response for status 200

Response example, 200:

```json
{
  "enqueued": true,
  "trace_count": 0,
  "traces": [
    {
      "trace_id": "string",
      "admitted": [
        "string"
      ],
      "skipped": [
        {
          "judge": "string",
          "reason": "on_demand_not_requested"
        }
      ]
    }
  ],
  "unknown_trace_ids": [
    "string"
  ],
  "unknown_judge_names": [
    "string"
  ]
}
```