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

# List open findings

> Page through a tenant's findings, filtered by audit, statement, category, state, period or date, with findings.

The `findings` query lists every finding of your tenant across audits, oldest first. Filter it with `query:` terms and read it a page at a time.

## The request

```bash theme={null}
curl -s "$DARPAN_API/rest/s1/graphql/public" \
  -H "Authorization: Bearer $DARPAN_GQL_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "query": "query Open($q: String, $after: String) { findings(first: 50, query: $q, after: $after) { edges { node { id audit statement category headline state firstFound ageDays records { system recordType id } } } pageInfo { hasNextPage endCursor } } }",
  "variables": { "q": "state:open period:2026-10" }
}
JSON
```

## Filter

Combine terms with spaces; every term must match. Separate values with commas to match any of them.

| Term | Matches |
| - | - |
| `audit:month-close` | Findings of that audit |
| `statement:R2,R8` | Findings that break either statement |
| `category:returns` | `orders`, `refundsAndCredits`, `returns` or `exchangesAndWarranty` |
| `state:open,pending` | `open`, `pending` or `fixed` |
| `period:2026-10` | Findings from that period's run |
| `firstFound:>=2026-10-20` | First found on or after a day. `>`, `<` and `<=` work too |

More on terms: [Search syntax](https://developers.drpn.ai/graphql/search-syntax.md).

## Read every page

`first` is at most 100. While `pageInfo.hasNextPage` is `true`, send the same query and variables again with `after` set to `pageInfo.endCursor`. Keep `sortKey` and `reverse` the same on every page; a cursor from one order is refused in another.

To sort by statement instead of date, pass `sortKey: STATEMENT`; `reverse: true` flips either order.

## Next

Each node's `id` is what [Read one finding](https://developers.drpn.ai/graphql/tasks/read-one-finding.md) takes. To keep a copy in your own system, see [Sync findings every day](https://developers.drpn.ai/graphql/tasks/sync-findings.md).

## Related

* [`findings` reference](https://developers.drpn.ai/graphql/queries/findings) and [`FindingListItem`](https://developers.drpn.ai/graphql/objects/finding-list-item)
* [Pagination](https://developers.drpn.ai/graphql/pagination.md)


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