findings

One finding with its evidence and history

get/findings/{findingId}

Request

  • Base URL: https://shruwd.io/api/v1
  • URL: https://shruwd.io/api/v1/findings/{findingId}
  • Auth: HTTP bearer

Response

The finding.

findingIdstring required
numberinteger required

1, 2, 3… per workspace, never reused. The dashboard links by it (/brands/{slug}/findings/{number}) and {findingId} accepts it.

ruleIdstring required
family'ACCESS' | 'STRUCT' | 'CITE' | 'FACT' | 'COVERAGE' required
severity'critical' | 'high' | 'medium' | 'low' required
confidence'observed' | 'inferred' | 'heuristic' required

observed — measured from first-party data. inferred — a reliable pattern. heuristic — plausible, unconfirmed; treat as a hypothesis.

state'open' | 'acknowledged' | 'fix_applied' | 'rechecking' | 'resolved' | 'not_moved' | 'dismissed' | 'stale' required
subjectType'url' | 'prompt_group' | 'domain' | 'brand' required
subjectRefstring required
evidenceobject required

What the rule saw. Shape depends on ruleId.

firstSeenAtstring date-time required
lastSeenAtstring date-time required
suppressedBystring nullable required

The finding that explains this one, when suppressed.

surfacedboolean required

False while the finding waits behind the weekly cap.

estimatedImpactnumber required
brandIdstring required
suppressedByNumberinteger nullable required

The number of suppressedBy, when suppressed.

stateChangedAtstring date-time required
baselineobject nullable required

The snapshot captured at fix_applied, which a recheck verdict is measured against: { capturedAt, window: { from, to }, promptGroups: [ { promptGroupId, x, n, modelIds } ] }. Null before a fix is marked applied.

Example response

{
  "ruleId": "ACCESS_ROBOTS_BLOCKS_AI"
}

Changes

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