---
title: "GET /api/v1/knowledge-health/findings"
method: GET
path: "/api/v1/knowledge-health/findings"
---

# GET /api/v1/knowledge-health/findings

`GET /api/v1/knowledge-health/findings`

## Request

- Base URL: `https://falconer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://falconer.com/api/v1/knowledge-health/findings`
- Auth: none declared

## Query parameters

- `category` 'contradiction' | 'gap' | 'redundancy' | 'freshness' | 'staleness' | 'drift', required: Category to list. One per call - the hosted UI shows one bucket at a time.
- `severity` 'critical' | 'moderate' | 'minor': Optional severity filter.
- `offset` integer, nullable
- `limit` integer

## Headers

- `x-organization-id` string: Required when using OAuth bearer tokens.

## Response `200`

Open findings for the requested category.

- KhFindingList
  - `total` integer, required
  - `nextOffset` integer, nullable, required
  - `findings` KhFinding[], required
    - `findingKey` string, required
    - `category` 'contradiction' | 'gap' | 'redundancy' | 'freshness' | 'staleness' | 'stale' | 'drift', required
    - `severity` 'critical' | 'moderate' | 'minor', required
    - `title` string, required
    - `description` string, required
    - `whyItMatters` string
    - `suggestedAction` string
    - `documents` KhFindingDocumentRef[], required
      - `documentId` string, required: Document UUID.
      - `title` string, required
      - `slug` string, required
      - `url` string, required: Absolute editor URL.
      - `archived` boolean, required
    - `labels` string[]
    - `evidence` object[]
      - `quote` string, required
      - `source` string
      - `url` string
    - `codeRefs` object[]
      - `repo` string, required
      - `path` string, required
      - `url` string
      - `line` number
    - `contributingPRs` object[]
      - `number` number, required
      - `url` string, required
      - `title` string, required
    - `actionStatus` string, nullable, required
    - `owner` object, nullable, required
      - `name` string, nullable, required
      - `email` string, nullable, required

## Other responses

- `400`: Bad request
- `403`: Knowledge Health v2 is not enabled for this organization

---

[API](https://skmtc.dev/falconer/apis/falconer-public-api.md) · [All operations](https://skmtc.dev/falconer/apis/falconer-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falconer/apis/falconer-public-api/revisions/7b303b7ddf6a?raw)