---
title: "List Lenses"
method: GET
path: "/lens"
tags: ["Lens"]
---

# List Lenses

`GET /lens`

## 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`
- Auth: API key in header `x-litellm-api-key`

## Response `200`

Successful Response

- LensList
  - `lenses` Lens[], required
    - `id` string, required
    - `scope` Scope, required
      - `team_id` string
      - `api_key_hash` string
      - `all_teams` boolean
    - `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
    - `version` integer
    - `created_at` string, date-time, required
    - `next_run_at` string, date-time, required
    - `last_scan_at` string, date-time, nullable
    - `jobs` 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[]
              - …
          - `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
    - `findings` Finding[]
      - `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[]
    - `budget_month` string, required
    - `spent` number
    - `reservations` BudgetReservation[]
      - `id` string, required
      - `job_id` string, required
      - `amount` number, required
      - `month` string, required
      - `expires_at` string, date-time, nullable
    - `criteria_updated_at` string, date-time, nullable
  - `workers` Worker[], required
    - `analysis_key_id` string, nullable
    - `id` string, required
    - `name` string, required
    - `scope` Scope, required
      - `team_id` string
      - `api_key_hash` string
      - `all_teams` boolean
    - `last_seen` string, date-time, required
    - `revoked` boolean
  - `tracing_enabled` boolean, required

## Changes

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

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/lens/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)