---
title: "List cases"
method: GET
path: "/v1/cases"
tags: ["Cases"]
---

# List cases

`GET /v1/cases`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/cases`
- Auth: HTTP bearer

Cases are document clusters discovered automatically from shared entity values across documents (BFS on the linking graph; inference mode may materialise them as first-class entities).

## Query parameters

- `search` string
- `min_documents` integer

## Response `200`

List of cases.

- object
  - `data` CaseListItem[]
    - `id` string, uuid, required: Case UUID — the stable resource id used in API paths.
    - `case_key` string, required: Content-derived key (hex hash of the member document set); distinct from `id`.
    - `label` string, nullable, required
    - `document_count` integer, required
    - `created_at` string, date-time, nullable
    - `links` object, required
      - `self` string

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)