Skip to content
Kritano Docs
Menu

Findings

An audit's findings, worst first

GET/api/v1/audits/{id}/findings

Needs the findings:read scope. About scopes

Dismissed findings are included; filter with status=active to leave them out.

Parameters

NameInTypeDescription
id requiredpathstring (uuid) Audit id
categoryquerystring `content` includes content-eeat and content-aeoOne of: seo, accessibility, security, performance, content, structured-data, content-eeat, content-aeo
severityquerystring One of: critical, serious, moderate, minor, info
statusquerystring One of: active, acknowledged, dismissed
pagequeryinteger From 1
limitqueryinteger Per page: default 20, at most 100

Responses

StatusMeaningBody
200OK FindingList
401No key, or the key is invalid, expired or revoked (key_required, key_invalid) Error
403The key lacks a scope, or the plan doesn't allow it (missing_scope, plan_no_api, plan_limit) Error
404Not found, or not yours (not_found) Error
429Over the rate limit (rate_limited, rate_limited_daily) Error

Examples

curl

curl "https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b/findings" \
  -H "Authorization: Bearer $KRITANO_API_KEY"

JavaScript

const res = await fetch("https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b/findings", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.KRITANO_API_KEY}`,
  },
});
const data = await res.json();

Python

import os
import requests

res = requests.get(
    "https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b/findings",
    headers={"Authorization": f"Bearer {os.environ['KRITANO_API_KEY']}"},
)
res.raise_for_status()
data = res.json()

Go

req, _ := http.NewRequest("GET", "https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b/findings", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KRITANO_API_KEY"))
res, err := http.DefaultClient.Do(req)