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 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.
API Token authentication
Domain name the scan was run for
example.comSuccess response
Domain name that was scanned
example.comScan status. Result fields are null until the status is completed.
completedPossible values: Agent readiness score from 0 to 100. Null unless completed, and null when unreachable.
78Letter grade for the score, from A to F. Null unless completed, and null when unreachable.
BWhether the website homepage could not be fetched
falseVersion of the scoring method that produced this scan
4Whether the scan was produced by an older scoring method than the current one
falseWhen the scan finished. Null unless completed.
2026-10-15T12:00:00ZScore breakdown per category. Null unless completed.
Categories where no check could be counted. They still cost their full weight. Null unless completed.
agent_interactionUnauthenticated response
Error response
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?