---
title: "Get Requirements Extraction Case"
method: GET
path: "/internal/evals/requirements-extraction/case"
tags: ["internal"]
---

# Get Requirements Extraction Case

`GET /internal/evals/requirements-extraction/case`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/internal/evals/requirements-extraction/case`
- Auth: none declared

One case's requirements, each with the paragraph it appears to have come from.

The source PDF is downloaded once for the whole case rather than once per requirement, and
grounding is computed here rather than in the browser because it needs the page geometry.

## Query parameters

- `run_id` string, required
- `case_id` string, required

## Response `200`

Successful Response

- ViewerCase
  - `case_id` string, required
  - `label` string, nullable
  - `filename` string, nullable
  - `document_type` string, nullable
  - `page_count` integer
  - `error` string, nullable
  - `preview_url` string, nullable
  - `preview_error` string, nullable
  - `located_something` boolean
  - `upload_id` string, nullable
  - `doc_type_scope_unknown` boolean
  - `extracted_nothing` boolean
  - `stores_nothing` boolean
  - `requirements` ViewerRequirement[]
    - `path` string, required
    - `verbatim_text` string, nullable
    - `section_label` string, nullable
    - `llm_guidelines` string, nullable
    - `trigger_terms` string[]
    - `applies_to_doc_types` string[]
    - `collateral_types` string[]
    - `claimed_page` integer, nullable
    - `hinted_page` integer, nullable
    - `defects` string[]
    - `grounding` GroundedSpan: Where a requirement appears to have come from, and how much to trust it.
      - `page_number` integer, required
      - `boxes` BoundingBox[]
        - `x0` number, required
        - `y0` number, required
        - `x1` number, required
        - `y1` number, required
      - `source_text` string, nullable
      - `matched_terms` string[]
      - `score` number
      - `basis` string
      - `cited_page` integer, nullable
      - `refusal` string, nullable
  - `discarded_texts` string[]
  - `discarded_count` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api.md) - [All operations](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/revisions/8587332d5e43?raw)