---
title: "List Project Claims"
method: GET
path: "/api/projects/{project_id}/claims"
tags: ["runtime_mutations", "ckg"]
---

# List Project Claims

`GET /api/projects/{project_id}/claims`

List claims for a project with optional filters and DAG expansion.

HTTP callers receive every matching claim — the per-call recency cap
that ``get_claims`` applies to the LLM tool path is intentionally not
propagated here, since UI surfaces (CKG sidebar, task-DAG coloring,
writeup tables) need the full set. ``claim_ids`` is repeatable
(``?claim_ids=C-1&claim_ids=C-2``) for bulk lookup of a known set
without re-scanning the project.

## Path parameters

- `project_id` string, required

## Query parameters

- `claim_type` string, nullable
- `minimum_recall_priority` 'global' | 'high' | 'medium' | 'low' — How readily a claim should enter an agent's context. This is a query-*independent* prior authored by the agent that files the claim. It is not relevance, confidence, or truth: a Low claim that is highly relevant to the current work must still be able to outrank an irrelevant Global one once the recall system ranks candidates. ``GLOBAL`` is the only value with delivery semantics rather than ranking semantics: it is injected unconditionally into every agent in the workspace. Every claim type carries a priority — evidence, figures, and findings can all be the thing future agents most need to see.
- `created_by_task_id` string, nullable
- `degree` integer
- `claim_ids` string[], nullable

## Response `200`

Successful Response

- ClaimsListResponse
  - `claims` ClaimResponse[], required
    - `claim_id` string, required
    - `project_id` string, required
    - `claim_type` string, required
    - `title` string, nullable
    - `content` string, required
    - `status` string, required
    - `review_status` string
    - `recall_priority` string
    - `created_by_session_id` string, nullable
    - `created_by_task_id` string, nullable
    - `updated_by_session_id` string, nullable
    - `linked_variable` object, nullable
    - `tabular_data` object, nullable
    - `figure_metadata` object, nullable
    - `created_at` string, required
    - `updated_at` string, required
    - `sources` ClaimSourceResponse[]
      - `id` integer, required
      - `claim_id` string, required
      - `source_type` string, required
      - `source_claim_id` string, nullable
      - `source_notebook_id` string, nullable
      - `source_notebook_path` string, nullable
      - `source_cell_id` string, nullable
      - `source_file_path` string, nullable
      - `source_section_heading` string, nullable
      - `source_line_start` integer, nullable
      - `source_line_end` integer, nullable
      - `source_text` string, nullable
      - `source_status` 'ok' | 'diverged' | 'missing' — Whether a recorded file-evidence quote still holds against the file.
      - `source_cell_part` 'source' | 'output' — Which half of a notebook cell a quoted span was taken from.
      - `source_output_index` integer, nullable
    - `related_claim_ids` string[]
    - `associated_tasks` AssociatedTaskResponse[]
      - `task_id` string, required
      - `title` string, required
      - `status` string, required
      - `assigned_to_session_id` string, nullable
    - `associated_notebooks` AssociatedNotebookResponse[]
      - `notebook_id` string, required
      - `path` string, nullable
  - `related` object[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quadrillion/quadrillion-cloud-api/versions/399077308c86/schema)