Get the latest agent readiness report
The most recent completed report for the project’s website, any newer run still in flight or failed, and the score history. Returns stored data only; it never starts a scan.
GET
https://api.usenotra.com
/
v1
/
projects
/
{projectId}
/
geo
/
agent-readiness
Get the latest agent readiness report
curl --request GET \
--url https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"targetUrl": "<string>",
"report": {
"id": "<string>",
"status": "running",
"targetUrl": "<string>",
"score": 123,
"scoreLabel": "<string>",
"scoreBreakdown": {
"essential": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"recommended": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"bonus": {
"points": 123,
"positiveSignals": 123
}
},
"issues": [
{
"id": "<string>",
"name": "<string>",
"tier": "essential",
"result": "failed",
"details": "<string>",
"recommendation": "<string>"
}
],
"eligibleChecks": 123,
"reportUrl": "<string>",
"errorMessage": "<string>",
"scannedAt": "<string>",
"createdAt": "<string>"
},
"scan": {
"id": "<string>",
"status": "running",
"targetUrl": "<string>",
"score": 123,
"scoreLabel": "<string>",
"scoreBreakdown": {
"essential": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"recommended": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"bonus": {
"points": 123,
"positiveSignals": 123
}
},
"issues": [
{
"id": "<string>",
"name": "<string>",
"tier": "essential",
"result": "failed",
"details": "<string>",
"recommendation": "<string>"
}
],
"eligibleChecks": 123,
"reportUrl": "<string>",
"errorMessage": "<string>",
"scannedAt": "<string>",
"createdAt": "<string>"
},
"history": [
{
"id": "<string>",
"score": 123,
"failedCount": 123,
"partialCount": 123,
"scannedAt": "<string>"
}
],
"organization": {
"id": "<string>",
"slug": "<string>",
"name": "<string>",
"logo": "<string>"
}
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}Authorizations
Send your API key in the Authorization header as Bearer API_KEY.
Path Parameters
Minimum string length:
1Pattern:
^[A-Za-z0-9_-]{1,100}$Example:
"b1f2c3d4-0000-4000-8000-000000000000"
Response
Report fetched successfully
Latest completed report, if any.
Show child attributes
Show child attributes
Latest run newer than the completed report, if any.
Show child attributes
Show child attributes
Completed scans, oldest first.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Last modified on September 18, 2026
Was this page helpful?
⌘I
Get the latest agent readiness report
curl --request GET \
--url https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usenotra.com/v1/projects/{projectId}/geo/agent-readiness")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"targetUrl": "<string>",
"report": {
"id": "<string>",
"status": "running",
"targetUrl": "<string>",
"score": 123,
"scoreLabel": "<string>",
"scoreBreakdown": {
"essential": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"recommended": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"bonus": {
"points": 123,
"positiveSignals": 123
}
},
"issues": [
{
"id": "<string>",
"name": "<string>",
"tier": "essential",
"result": "failed",
"details": "<string>",
"recommendation": "<string>"
}
],
"eligibleChecks": 123,
"reportUrl": "<string>",
"errorMessage": "<string>",
"scannedAt": "<string>",
"createdAt": "<string>"
},
"scan": {
"id": "<string>",
"status": "running",
"targetUrl": "<string>",
"score": 123,
"scoreLabel": "<string>",
"scoreBreakdown": {
"essential": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"recommended": {
"earned": 123,
"available": 123,
"passing": 123,
"total": 123
},
"bonus": {
"points": 123,
"positiveSignals": 123
}
},
"issues": [
{
"id": "<string>",
"name": "<string>",
"tier": "essential",
"result": "failed",
"details": "<string>",
"recommendation": "<string>"
}
],
"eligibleChecks": 123,
"reportUrl": "<string>",
"errorMessage": "<string>",
"scannedAt": "<string>",
"createdAt": "<string>"
},
"history": [
{
"id": "<string>",
"score": 123,
"failedCount": 123,
"partialCount": 123,
"scannedAt": "<string>"
}
],
"organization": {
"id": "<string>",
"slug": "<string>",
"name": "<string>",
"logo": "<string>"
}
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}