Agent Readiness: Scans

Get agent readiness scan

Changed on

Get the latest agent readiness scan of a website.\n Scans started with the Run agent readiness scan operation are asynchronous. While the status is pending, the result fields are null; wait a few seconds and call this operation again until the status is completed or failed. A failed scan is not retried; run the scan again.\n A completed scan has a 0-100 score, a letter grade, a score per category, and the result of every check with the evidence found and how to fix it. Check names are listed by the List checks operation.\n Returns 404 when the domain has never been scanned; use the Run agent readiness scan operation first.

get/api/agent-readiness/v1/scans/{domain}

Request

  • Base URL: https://developers.hostinger.com
  • URL: https://developers.hostinger.com/api/agent-readiness/v1/scans/{domain}
  • Auth: HTTP bearer

Path parameters

domainstring required
Example:example.com

Domain name the scan was run for

Response

Success response

domainstring required

Domain name that was scanned

status'pending' | 'completed' | 'failed' required

Scan status. Result fields are null until the status is completed.

scoreinteger nullable required

Agent readiness score from 0 to 100. Null unless completed, and null when unreachable.

gradestring nullable required

Letter grade for the score, from A to F. Null unless completed, and null when unreachable.

is_unreachableboolean required

Whether the website homepage could not be fetched

scanner_versioninteger required

Version of the scoring method that produced this scan

is_outdatedboolean required

Whether the scan was produced by an older scoring method than the current one

scanned_atstring date-time nullable required

When the scan finished. Null unless completed.

unassessed_categoriesstring[] nullable required

Categories where no check could be counted. They still cost their full weight. Null unless completed.

Example response

{
  "domain": "example.com",
  "status": "completed",
  "score": 78,
  "grade": "B",
  "scanner_version": 4,
  "scanned_at": "2026-10-15T12:00:00Z",
  "categories": {
    "crawl_permission": {
      "score": 15,
      "weight": 20,
      "earned": 15,
      "possible": 20
    },
    "findability": {
      "score": 15,
      "weight": 20,
      "earned": 15,
      "possible": 20
    },
    "readability": {
      "score": 15,
      "weight": 20,
      "earned": 15,
      "possible": 20
    },
    "structured_meaning": {
      "score": 15,
      "weight": 20,
      "earned": 15,
      "possible": 20
    },
    "commercial_legibility": {
      "score": 15,
      "weight": 20,
      "earned": 15,
      "possible": 20
    },
    "agent_native_content": {
      "score": 15,
      "weight": 20,
      "earned": 15,
      "possible": 20
    },
    "agent_interaction": {
      "score": 15,
      "weight": 20,
      "earned": 15,
      "possible": 20
    }
  },
  "unassessed_categories": [
    "agent_interaction"
  ],
  "results": [
    {
      "check_id": "crawl_permission.robots_txt_valid",
      "category": "crawl_permission",
      "status": "pass",
      "earned": 4,
      "possible": 4,
      "evidence": "robots.txt returned 200 and parsed cleanly"
    }
  ]
}

Changes