For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get agent readiness scan

Get the latest agent readiness scan of a website.\n Scans started with the Run agent readiness scan operation are asynchronous.

Get agent readiness scan

get

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.

Authorizations
AuthorizationstringRequired

API Token authentication

Path parameters
domainstringRequired

Domain name the scan was run for

Example: example.com
Responses
200

Success response

application/json
domainstringRequired

Domain name that was scanned

Example: example.com
statusstring · enumRequired

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

Example: completedPossible values:
scoreinteger · nullableRequired

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

Example: 78
gradestring · nullableRequired

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

Example: B
is_unreachablebooleanRequired

Whether the website homepage could not be fetched

Example: false
scanner_versionintegerRequired

Version of the scoring method that produced this scan

Example: 4
is_outdatedbooleanRequired

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

Example: false
scanned_atstring · date-time · nullableRequired

When the scan finished. Null unless completed.

Example: 2026-10-15T12:00:00Z
categoriesone of · nullableRequired

Score breakdown per category. Null unless completed.

unassessed_categoriesstring[] · nullableRequired

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

Example: agent_interaction
get/api/agent-readiness/v1/scans/{domain}
GET /api/agent-readiness/v1/scans/{domain} HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "domain": "example.com",
  "status": "completed",
  "score": 78,
  "grade": "B",
  "is_unreachable": false,
  "scanner_version": 4,
  "is_outdated": false,
  "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",
      "fix": null
    }
  ]
}

Last updated

Was this helpful?