---
title: "Eval Cases"
method: GET
path: "/lens/datasets/{dataset_id}/revisions/{revision}/cases"
tags: ["Lens"]
---

# Eval Cases

`GET /lens/datasets/{dataset_id}/revisions/{revision}/cases`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/lens/datasets/{dataset_id}/revisions/{revision}/cases`
- Auth: API key in header `x-litellm-api-key`

## Path parameters

- `dataset_id` string, required
- `revision` integer, required

## Response `200`

Successful Response

- EvalCases
  - `dataset_id` string, required
  - `revision` integer, required
  - `cases` DatasetCase[], required
    - `id` string, required
    - `messages` DatasetMessage[], required
      - `role` 'system' | 'user' | 'assistant' | 'tool', required
      - `content` string, required
      - `name` string
      - `tool_calls` DatasetToolCall[]
        - `name` string, required
        - `arguments` string, required
    - `reply` string
    - `tool_calls` DatasetToolCall[]
      - `name` string, required
      - `arguments` string, required
    - `expected` string
    - `included` boolean
    - `source` CaseSource, required
      - `trace_id` string
      - `trace_ref` string
      - `span_id` string
      - `finding_id` string
      - `lens_id` string
    - `agent_version` string

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/lens/datasets/:dataset_id/revisions/:revision/cases/get.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)