Developer docs

List issues

GET/sites/{siteId}/issues
Scope
issues:read
MCP tool
list_issues

List issues The same list as the app's Issues screen, newest first (at most 500). Keyword tasks (KW-*) are left out here and listed under /actions.

Parameters

NameInDetails
siteIdRequiredpathstringWebsite id, from GET /sites.
statusquerystringComma-separated statuses: open, in_progress, recheck_queued, resolved, ignored, reopened. Default: open, reopened, in_progress, recheck_queued.

Response

200 · application/json

FieldDetails
issueslist of values · required
issues[].idstring
issues[].ruleIdstring
issues[].titlestring
issues[].categorystring
issues[].severitystring
issues[].confidencestring
issues[].statusstring
issues[].affectedPagesnumber
issues[].templatestring
issues[].summarystring
issues[].firstSeenstring
issues[].lastSeenstring
issues[].lastRecheckobject
issues[].lastRecheck.atstring
issues[].lastRecheck.presentnumber
issues[].lastRecheck.checkednumber
issues[].lastRecheck.crawlIdstring
issues[].lastRecheck.passedtrue or false
issues[].linkstring

Errors

StatusMeaning
401Missing, unknown or revoked key. Codes: missing_key, invalid_key.
403The key lacks the scope, covers another website, or its owner lost access. Codes: missing_scope, other_site, owner_left, no_owner, forbidden.
404Not found. Codes: not_found.
429Too many requests this hour for this key. Codes: rate_limited.

Example request

curl \
  -H "Authorization: Bearer mr_ws_…" \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/issues"

Example response

{
  "issues": [
    {
      "id": "b2e4c6a8-1d3f-4a5b-9c7d-0e2f4a6b8c1d",
      "ruleId": "SEO-ONP-011",
      "title": "Meta description missing on 3 pages (/products/*)",
      "category": "On-page",
      "severity": "warning",
      "confidence": "high",
      "status": "open",
      "affectedPages": 3,
      "template": "Template: /products/*",
      "summary": "3 pages have no meta description. Google shows a snippet cut from the page instead.",
      "firstSeen": "2026-09-20T02:40:03.000Z",
      "lastSeen": "2026-10-04T02:41:12.000Z",
      "lastRecheck": {
        "at": "2026-10-02T09:12:44.000Z",
        "present": 3,
        "checked": 3,
        "crawlId": "e5a7c9e1-3f5b-4d7f-9b1d-5f7b9d1f3b5c",
        "passed": false
      },
      "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/issues/b2e4c6a8-1d3f-4a5b-9c7d-0e2f4a6b8c1d"
    }
  ]
}

The MCP server does the same with the tool list_issues.