---
title: Get agent readiness summary
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Radar](https://developers.cloudflare.com/api/resources/radar)
[Agent Readiness](https://developers.cloudflare.com/api/resources/radar/subresources/agent_readiness)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Get agent readiness summary
GET/radar/agent\_readiness/summary/{dimension}
Returns a summary of AI agent readiness scores across scanned domains, grouped by the specified dimension. Data is sourced from weekly bulk scans. All values are raw domain counts.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`User Details Write``User Details Read`
##### P ath ParametersExpand Collapse
dimension: "CHECK"
Specifies the agent readiness data dimension by which to group the results.
[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(method)%20summary%20%3E%20(params)%20default%20%3E%20(param)%20dimension%20%3E%20(schema)>)
##### Q uery ParametersExpand Collapse
date: optional string
Filters results by the specified date.
formatdate
[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(method)%20summary%20%3E%20(params)%20default%20%3E%20(param)%20date%20%3E%20(schema)>)
domainCategory: optional array of string
Filters results by domain category.
[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(method)%20summary%20%3E%20(params)%20default%20%3E%20(param)%20domainCategory%20%3E%20(schema)>)
format: optional "JSON"or "CSV"
Format in which results will be returned.
One of the following:
"JSON"
Link to this property
"CSV"
Link to this property
[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(method)%20summary%20%3E%20(params)%20default%20%3E%20(param)%20format%20%3E%20(schema)>)
name: optional array of string
Array of names used to label the series in the response.
[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(method)%20summary%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)
##### ReturnsExpand Collapse
result: object {meta, summary\_0 }
meta: object {date, domainCategories, lastUpdated, 4 more }
date: string
Date of the returned scan (YYYY-MM-DD). May differ from the requested date if no scan exists for that exact date.
formatdate
Link to this property
domainCategories: array of object {name, value }
Available domain sub-categories with their scan counts. Use as filter options for the domainCategory parameter.
name: string
Sub-category name.
Link to this property
value: number
Number of successfully scanned domains in this sub-category.
Link to this property
Link to this property
lastUpdated: string
Timestamp of the last dataset update.
formatdate-time
Link to this property
normalization: "PERCENTAGE"or "MIN0\_MAX"or "MIN\_MAX"or 5 more
Normalization method applied to the results. Refer to Normalization methods.
One of the following:
"PERCENTAGE"
Link to this property
"MIN0\_MAX"
Link to this property
"MIN\_MAX"
Link to this property
"RAW\_VALUES"
Link to this property
"PERCENTAGE\_CHANGE"
Link to this property
"ROLLING\_AVERAGE"
Link to this property
"OVERLAPPED\_PERCENTAGE"
Link to this property
"RATIO"
Link to this property
Link to this property
successfulDomains: number
Domains successfully scanned (excludes errors).
Link to this property
totalDomains: number
Total domains attempted in the scan.
Link to this property
units: array of object {name, value }
Measurement units for the results.
name: string
Link to this property
value: string
Link to this property
Link to this property
Link to this property
summary\_0: map\[string]
Link to this property
[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(method)%20summary%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: boolean
[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(method)%20summary%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### Get agent readiness summary
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/radar/agent_readiness/summary/$DIMENSION \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
```
{
"result": {
"meta": {
"date": "2026-03-24",
"domainCategories": [
{
"name": "News & Media",
"value": 0
}
],
"lastUpdated": "2019-12-27T18:11:19.117Z",
"normalization": "PERCENTAGE",
"successfulDomains": 0,
"totalDomains": 0,
"units": [
{
"name": "*",
"value": "requests"
}
]
},
"summary_0": {
"markdownNegotiation": "45000",
"robotsTxt": "280000"
}
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"result": {
"meta": {
"date": "2026-03-24",
"domainCategories": [
{
"name": "News & Media",
"value": 0
}
],
"lastUpdated": "2019-12-27T18:11:19.117Z",
"normalization": "PERCENTAGE",
"successfulDomains": 0,
"totalDomains": 0,
"units": [
{
"name": "*",
"value": "requests"
}
]
},
"summary_0": {
"markdownNegotiation": "45000",
"robotsTxt": "280000"
}
},
"success": true
}
```