Findings

The finding inbox

Outstanding problems rather than audit results. A finding is one problem on one logical page against one requirement, for as long as that pairing exists: a page that fails the same rule every night is one finding, not one per night. Defaults to everything not resolved. Use sort=created for bounded cursor pages, newest creation time then ID descending. Creation time is immutable when a later audit sees the same problem, so updates do not move findings across the cursor. Filters are evaluated on each request; pages are not a frozen snapshot of membership. Omit sort for the legacy last-seen descending, ID ascending offset list. Summary counts are separate from the number of loaded findings.

get/v1/findings

Request

  • Base URL: https://api.ironfang.com/audit
  • URL: https://api.ironfang.com/audit/v1/findings
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Query parameters

site_idstring uuid
page_idstring uuid
rule_idstring uuid

The rule lineage id, so a reworded rule keeps its findings.

statestring[]

Repeatable. Omit for everything still outstanding.

severity'info' | 'warning' | 'failure' | 'critical'
assigneestring
open_longer_than_daysinteger

Findings first seen more than this many days ago.

limitinteger
sort'last_seen' | 'created'
cursorstring

Returned next_cursor; valid only with sort=created. Omit on the first page.

offsetinteger

Legacy last-seen list only; cannot be combined with sort=created.

Response

Findings; next_cursor is present only when another creation-ordered page exists.

next_cursorstring

Changes

No recorded changes to this operation across all 1 revision of this API.