---
title: "Read Run"
method: GET
path: "/lens/{lens_id}/runs/{job_id}"
tags: ["Lens"]
---

# Read Run

`GET /lens/{lens_id}/runs/{job_id}`

## 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/{lens_id}/runs/{job_id}`
- Auth: API key in header `x-litellm-api-key`

## Path parameters

- `lens_id` string, required
- `job_id` string, required

## Response `200`

Successful Response

- Job
  - `id` string, required
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
  - `stage` string
  - `created_at` string, date-time, required
  - `start` string, date-time, required
  - `end` string, date-time, required
  - `settings` LensSettings, required
    - `source` 'traces' | 'requests' | 'both'
    - `service` string
    - `agent_name` string
    - `filters` MetadataFilter[]
      - `key` string, required
      - `value` string, required
    - `sample_size` integer, nullable
    - `sample_percent` number
    - `team_id` string
    - `execution_ids` string[]
    - `name` string, required
    - `context` string
    - `lookback_hours` integer
    - `checks` Check[]
      - `id` string, required
      - `instruction` string, required
      - `enabled` boolean
    - `model` string, required
    - `enabled` boolean
    - `interval_minutes` integer
    - `concurrency` integer
    - `monthly_budget` number
  - `revision` integer, required
  - `worker_id` string, nullable
  - `lease_until` string, date-time, nullable
  - `attempts` integer
  - `finished_at` string, date-time, nullable
  - `coverage` Coverage
    - `eligible` integer
    - `selected` integer
    - `screened` integer
    - `investigated` integer
    - `inconclusive` integer
    - `grouping_batches` integer
    - `grouped_batches` integer
    - `candidates` integer
    - `partial` integer
    - `unassessable` integer
    - `failed_tasks` integer
    - `reused` integer
    - `reusable` integer
  - `error` string
  - `sample` Sample
    - `executions` Execution[], required
      - `id` string, required
      - `source` 'traces' | 'requests', required
      - `trace_id` string, required
      - `trace_ref` string
      - `team_id` string, required
      - `name` string, required
      - `start_time` string, required
      - `span_count` integer, required
      - `root_seen` boolean
      - `service` string
      - `metadata` MetadataFilter[]
        - `key` string, required
        - `value` string, required
    - `eligible` integer, required
    - `selected` integer
    - `next_offset` integer, nullable
    - `next_cursor` string, nullable
  - `cost` number
  - `findings` Finding[], nullable
    - `title` string, required
    - `description` string, required
    - `check_id` string, required
    - `kind` 'issue' | 'pattern'
    - `priority` 'high' | 'medium' | 'low'
    - `suggestion` string
    - `limitation` string
    - `brief` IssueBrief
      - `problem` string, required
      - `user_goal` string, required
      - `what_happened` string, required
      - `test_cases` AgentTestCase[], required
        - `input` string, required
        - `expected` string, required
    - `evidence` Evidence[], required
      - `execution_id` string, required
      - `span_id` string, required
      - `quote` string, required
      - `role` 'support' | 'counterexample'
    - `existing_finding_id` string, nullable
    - `check_ids` string[]
    - `merged_finding_ids` string[]
    - `id` string, required
    - `status` 'open' | 'resolved' | 'dismissed'
    - `reason` string
    - `first_seen` string, date-time, required
    - `last_seen` string, date-time, required
    - `occurrences` string[]
    - `revision` integer, required
    - `investigation_runs` string[]
  - `assessments` RunAssessment[]
    - `execution_id` string, required
    - `issue_checks` string[]
    - `pattern_checks` string[]
    - `cannot_assess` boolean
  - `steps` Step[]
    - `at` string, date-time, required
    - `kind` 'stage' | 'model' | 'error', required
    - `label` string, required
    - `model` string
    - `purpose` string
    - `prompt_tokens` integer
    - `completion_tokens` integer
    - `cost` number
  - `reviews` Review[]
    - `execution_id` string, required
    - `trace_id` string, required
    - `agent` string, required
    - `name` string, required
    - `spans` ReviewSpan[]
      - `span_id` string, required
      - `name` string, required
      - `kind` string, required
      - `preview` string, required
      - `cited` boolean
    - `reasoning` string
    - `verdicts` ReviewVerdict[]
      - `check_id` string, required
      - `kind` 'issue' | 'pattern', required
      - `summary` string, required
    - `cannot_assess` boolean
    - `model` string, required
    - `duration_ms` integer, required
    - `at` string, date-time, required
    - `tool_calls` ToolCount[]
      - `name` 'model' | 'read' | 'search' | 'python' | 'catalog' | 'review_catalog' | 'read_reviews' | 'search_reviews' | 'history' | 'checkpoint', required
      - `calls` integer, required
    - `extraction` Extraction
      - `observations` Observation[]
        - `check_id` string, required
        - `kind` 'issue' | 'pattern'
        - `summary` string, required
        - `evidence` Evidence[]
          - `execution_id` string, required
          - `span_id` string, required
          - `quote` string, required
          - `role` 'support' | 'counterexample'
      - `cannot_assess` boolean
      - `reasoning` string
    - `content_version` string
    - `reused` boolean
    - `consolidated` boolean
    - `partial` boolean
  - `reviewed` integer
  - `reading` InFlight[]
    - `execution_id` string, required
    - `trace_id` string, required
    - `agent` string, required
    - `started_at` string, date-time, required
  - `activities` Activity[]
    - `id` string, required
    - `phase` 'load' | 'review' | 'group' | 'reconcile' | 'investigate', required
    - `label` string, required
    - `execution_ids` string[]
    - `started_at` string, date-time, required
    - `operations` string[]
    - `tool_calls` ToolCount[]
      - `name` 'model' | 'read' | 'search' | 'python' | 'catalog' | 'review_catalog' | 'read_reviews' | 'search_reviews' | 'history' | 'checkpoint', required
      - `calls` integer, required
    - `finished` boolean
  - `trigger` 'schedule' | 'manual'
  - `review_versions` ReviewVersion[]
    - `execution_id` string, required
    - `content_version` string, required

## 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/:lens_id/runs/:job_id/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)