> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Findings

> Page through a review's findings, filtered by status and severity.

> [!NOTE]
>
> **Preview.** This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive `403 mcp_not_enabled`. See the [preview overview](/preview).

Returns a page of a review's findings, in document order. A finding is one check's result, with its explanation, the text it relied on and any amendments it proposes. A check the reviewer switched off has no finding.

Findings appear as checks complete, so a running review returns a partial list. Wait for the review's operation to succeed before you act on the full set.

## Authentication

Requires an API key, or an OAuth token with `reviews:read`.

## Path parameters

**review\_id** `string` *required*

The review id.

## Query parameters

**status** `string`

Only findings with this status: `issue`, `ok`, `not_applicable` or `error`. Pass `issue` to skip the checks that passed.

**severity** `string`

Only findings with this severity: `high`, `medium` or `low`. Only issues have a severity.

**cursor** `string`

The `cursor` from the previous page. Omit it for the first page.

**limit** `integer` (default: 50)

Findings per page, from `1` to `200`.

## Response

Returns `200` with `{"items": [...], "cursor": "..."}`. `cursor` is `null` on the last page. Each item is a finding:

**id** `string` *required*

The finding's id, which is its check's id in this review. Pass it to [Generate Redline](/api-reference/reviews/generate-redline).

**name** `string` *required*

The check's name.

**status** `string` *required*

`issue` when the document fails the check, `ok` when it passes, `not_applicable` when the check did not apply, or `error` when the check could not run.

**severity** `string | null`

`high`, `medium` or `low`, set for issues.

**explanation** `string | null`

Why, with reference to the playbook position or your instructions.

**citations** `object[]` *required*

`{ "file_id", "text" }` for each passage relied on. `file_id` is one of the review's `file_ids`, or `null` when the text comes from elsewhere.

**amendments** `object[]` *required*

The changes the check proposes, each `{ "id", "type", "preview" }`. `type` is `modification`, `insertion`, `deletion` or `comment`, and `preview` is the change in Markdown. Empty when the check proposes none.

```bash cURL theme={null}
curl "https://api.wordsmith.ai/api/v1/reviews/5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58/findings?status=issue&severity=high" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={null}
{
  "items": [
    {
      "id": "71911999-dbe8-438b-8f03-dfd349c2da40",
      "name": "Limitation of liability",
      "status": "issue",
      "severity": "high",
      "explanation": "The playbook requires a cap of 12 months' fees for all claims except fraud. Clause 11.3 carves confidentiality out of the cap entirely.",
      "citations": [
        {
          "file_id": "4d2e6f81-3a5b-4c7d-9e0f-1a2b3c4d5e6f",
          "text": "Nothing in this Agreement limits either party's liability for breach of clause 9 (Confidentiality)."
        }
      ],
      "amendments": [
        {
          "id": "5e181f29-64be-4128-ab3c-8f4b1c35f71e",
          "type": "modification",
          "preview": "~~Nothing in this Agreement limits either party's liability~~ Each party's liability for breach of clause 9 (Confidentiality) is limited to twice the fees paid in the 12 months before the claim."
        }
      ]
    }
  ],
  "cursor": null
}
```

## Errors

| Status | `error_code` | When |
| - | - | - |
| 400 | `bad_request` | A filter value is not allowed, `limit` is outside `1`–`200`, or `cursor` is not one this endpoint returned. |
| 404 | `resource_not_found` | No review with this id, or the caller cannot read it. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.