---
title: "Get a requirement"
method: GET
path: "/api/requirements/{id}"
tags: ["Requirements"]
---

# Get a requirement

`GET /api/requirements/{id}`

## Request

- Base URL: `https://demo.supercheck.dev`
- URL: `https://demo.supercheck.dev/api/requirements/{id}`
- Auth: HTTP bearer

Fetch one requirement with tag names, linked test IDs and coverage. Requires `requirement:view`. Malformed IDs return 404.

## Response `200`

Requirement

- RequirementResponse
  - `requirement` Requirement: Requirement as returned by the detail, create, update and test-link endpoints.
    - `id` string, uuid
    - `title` string
    - `description` string, nullable
    - `priority` 'low' | 'medium' | 'high', nullable
    - `tags` string[]: Tag names.
    - `externalId` string, nullable
    - `externalUrl` string, nullable
    - `testIds` string[]
    - `coverage` RequirementCoverage
      - `status` 'covered' | 'failing' | 'missing'
      - `linkedTestCount` integer
      - `passedTestCount` integer
      - `failedTestCount` integer
      - `lastEvaluatedAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `401`: Authentication required or token invalid
- `403`: Insufficient permissions
- `404`: Resource not found

## Changes

- **2026-10-25** `9d4e9599f8c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/requirements/:id/get.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) - [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) - [OpenAPI document](https://skmtc.dev/supercheck-io/apis/supercheck-api/revisions/7fa0162c07bd?raw)