Compliance

List compliance findings

Deterministic verdicts against the published rules, newest first and keyset-paginated on (first_detected_at, finding_id). A finding stays open until the registration is corrected, at which point the next scan stamps resolved_at; first_detected_at survives every re-scan. Distinct from /v1/anomalies, which reports observed behaviour rather than rule breaches. The first page's meta.facets gives rule and grade counts over the filtered set.

get/v1/compliance/findings

Request

  • Base URL: https://api.peppolstatus.com
  • URL: https://api.peppolstatus.com/v1/compliance/findings
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

rulestring

Filter to one rule code (from GET /v1/compliance/rules).

countrystring

Filter to one ISO 3166-1 alpha-2 country.

seatstring

Filter to one operating seat id (e.g. PBE000123).

schemestring

Filter to one participant scheme id, for participant-grain rules.

grade'fatal' | 'warning' | 'notice'

Filter by severity.

status'open' | 'resolved' | 'all'

Lifecycle slice; defaults to the open findings.

sincestring date-time

Only findings whose last_seen_at or resolved_at is at or after this ISO 8601 instant: everything the latest scans still confirm, plus everything opened, changed or resolved since. A finding whose evidence has not moved for weeks stays in the answer for as long as its rule keeps being scanned, so polling this converges on the live set.

limitinteger

Page size, clamped to [1, 200]. Defaults to 50.

cursorstring

Opaque pagination cursor returned as next_cursor by the previous page.

Response

A page of compliance findings with rule/grade facets.

next_cursorstring nullable required

Opaque cursor for the next page, or null on the last page.

Changes

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