Skip to main content
GET
List site audit issues

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.

Query Parameters

cursor
string

Cursor from the previous response's nextCursor

issues

Checks to include. Repeat for multiple: issues=status4xx&issues=missingTitle. Omit for every check that fired. Ids: status4xx, status5xx, brokenInternalLink, redirectChainTooLong, missingTitle, noH1, certificateInvalid, sitemapUrlRedirects, orphanPage, missingDescription, multipleH1, thinContent, slowTtfb, oversizedHtml, certificateExpiringSoon, linkedNotInSitemap, titleLengthOutOfRange, externalCanonical, duplicateContent, navOnlyPage, contentRequiresJs. Check id (status4xx, status5xx, brokenInternalLink, redirectChainTooLong, missingTitle, noH1, certificateInvalid, sitemapUrlRedirects, orphanPage, missingDescription, multipleH1, thinContent, slowTtfb, oversizedHtml, certificateExpiringSoon, linkedNotInSitemap, titleLengthOutOfRange, externalCanonical, duplicateContent, navOnlyPage, contentRequiresJs)

Available options:
status4xx,
status5xx,
brokenInternalLink,
redirectChainTooLong,
missingTitle,
noH1,
certificateInvalid,
sitemapUrlRedirects,
orphanPage,
missingDescription,
multipleH1,
thinContent,
slowTtfb,
oversizedHtml,
certificateExpiringSoon,
linkedNotInSitemap,
titleLengthOutOfRange,
externalCanonical,
duplicateContent,
navOnlyPage,
contentRequiresJs
limit
integer
default:50

Page size (default 50, max 200)

Required range: 1 <= x <= 200
runId
string<uuid>

Defaults to the latest finished run

Case-insensitive URL substring

Maximum string length: 200
severity
enum<string>

Check severity

Available options:
error,
warning,
notice

Response

Default Response

counts
object
required

Affected URLs per check under the URL search alone, so a filter can show what a pick would leave

nextCursor
string | null
required

Pass as cursor to fetch the next page; null on the last page

rows
object[]
required

Affected URLs, errors first, then by check within a tier

runId
string<uuid>
required

Run the response was read from

total
integer
required

Affected URLs matching the filters