---
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`

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/fastapi.md) · [All operations](https://skmtc.dev/kobaltlabs/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kobaltlabs/fastapi/revisions/3ff4c0bd276b/schema)