# Review recorded findings

> Read the conditions BanSafe recorded on a Number, check when each was last seen, and acknowledge them.

A finding records a condition BanSafe observed on a Number at a specific
time, with the evidence and a suggested fix. Findings are separate from
Health: they do not change the score, and a new Health estimate does not
refresh or resolve them.

## Before you begin

- To read findings through the API, use a team key or project token with
  `sessions:read`.
- To acknowledge a finding, sign in to the Console as a team owner or admin.

## Read findings

**Console:**

Open the project's **Safety** page and select a Number. **Findings**
lists each finding with its title, what was seen, the fix and when it was last
seen. A check that could not be measured shows a dash and the reason, never a
green check.

**API:**

```bash
curl "https://api.polymorfa.com/platform/bansafe/findings?projectId=$PROJECT_ID&status=open" \
  -H "Authorization: Bearer $POLYMORFA_API_KEY"
```

Filter by `session`, `status` or `severity`. One Number's findings are also in
`GET /platform/bansafe/health/{session}`. See
[List findings](https://docs.polymorfa.com/api/bansafe/list-ban-safe-findings).

Each finding carries:

| Field | Meaning |
| --- | --- |
| `key` | Stable identifier of the check. |
| `title` | Readable name. |
| `summary` | A sentence built from the evidence. |
| `fix` | The change that addresses it. |
| `severity` | Severity at the last update. |
| `status` | `open`, `acknowledged` or `resolved`. |
| `evidence` | Bounded numbers: counts, ratios and timing summaries. |
| `firstSeenAt`, `lastSeenAt` | When the condition was first and last observed. |
| `occurrences`, `reopenedCount` | How often it was seen and reopened. |

Read `lastSeenAt` before acting on a finding. The condition can have changed
since then.

## Acknowledge a finding

Acknowledging records that a named person on your team has seen the finding.
Support reads acknowledgements when reviewing an appeal, so API keys and
project tokens cannot acknowledge.

1. Open the Number on the **Safety** page. Under **Findings**, select
   **Acknowledge** on the finding.
2. Optionally add a note of up to 500 characters.
3. Optionally snooze the finding's notifications for 1 to 30 days.
4. Confirm.

The row then shows who acknowledged it and when. Acknowledging an already
acknowledged finding keeps the original details.

> **Warning**
>
> **Acknowledging does not fix anything.** It does not change Health and does
> not lift a restriction. Health changes after new evidence, and a restriction
> lifts when its recovery conditions are met.

You must acknowledge every open finding on a Number before you can
[appeal a restriction](https://docs.polymorfa.com/safety/restrictions#appeal-a-restriction).

## What evidence contains

Evidence is bounded counts, ratios and timing summaries. It never contains
message text, media, message identifiers, recipient identifiers or chat
history.

## See also

- [Read a Number's Health](https://docs.polymorfa.com/safety/health)
- [Set a Health rule and handle restrictions](https://docs.polymorfa.com/safety/restrictions)
- [Safety in the Console](https://docs.polymorfa.com/safety/console)
