Get agent readiness summary

client.Radar.AgentReadiness.Summary(ctx, dimension, query) (*AgentReadinessSummaryResponse, error)

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 WriteUser Details Read

ParametersExpand Collapse

dimension AgentReadinessSummaryParamsDimension

Specifies the agent readiness data dimension by which to group the results.

query AgentReadinessSummaryParams

Date param.Field[Time]Optional

Filters results by the specified date.

formatdate

DomainCategory param.Field[[]string]Optional

Filters results by domain category.

Format param.Field[AgentReadinessSummaryParamsFormat]Optional

Format in which results will be returned.

const AgentReadinessSummaryParamsFormatJson AgentReadinessSummaryParamsFormat = "JSON"

const AgentReadinessSummaryParamsFormatCsv AgentReadinessSummaryParamsFormat = "CSV"

Name param.Field[[]string]Optional

Array of names used to label the series in the response.

ReturnsExpand Collapse

type AgentReadinessSummaryResponse struct{…}

Meta AgentReadinessSummaryResponseMeta

Date string

Date of the returned scan (YYYY-MM-DD). May differ from the requested date if no scan exists for that exact date.

DomainCategories []AgentReadinessSummaryResponseMetaDomainCategory

Available domain sub-categories with their scan counts. Use as filter options for the domainCategory parameter.

Name string

Sub-category name.

Value int64

Number of successfully scanned domains in this sub-category.

LastUpdated Time

Timestamp of the last dataset update.

formatdate-time

Normalization AgentReadinessSummaryResponseMetaNormalization

Normalization method applied to the results. Refer to Normalization methods.

One of the following:

const AgentReadinessSummaryResponseMetaNormalizationPercentage AgentReadinessSummaryResponseMetaNormalization = "PERCENTAGE"

const AgentReadinessSummaryResponseMetaNormalizationMin0Max AgentReadinessSummaryResponseMetaNormalization = "MIN0_MAX"

const AgentReadinessSummaryResponseMetaNormalizationMinMax AgentReadinessSummaryResponseMetaNormalization = "MIN_MAX"

const AgentReadinessSummaryResponseMetaNormalizationRawValues AgentReadinessSummaryResponseMetaNormalization = "RAW_VALUES"

const AgentReadinessSummaryResponseMetaNormalizationPercentageChange AgentReadinessSummaryResponseMetaNormalization = "PERCENTAGE_CHANGE"

const AgentReadinessSummaryResponseMetaNormalizationRollingAverage AgentReadinessSummaryResponseMetaNormalization = "ROLLING_AVERAGE"

const AgentReadinessSummaryResponseMetaNormalizationOverlappedPercentage AgentReadinessSummaryResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const AgentReadinessSummaryResponseMetaNormalizationRatio AgentReadinessSummaryResponseMetaNormalization = "RATIO"

SuccessfulDomains int64

Domains successfully scanned (excludes errors).

TotalDomains int64

Total domains attempted in the scan.

Units []AgentReadinessSummaryResponseMetaUnit

Measurement units for the results.

Name string

Value string

Summary0 map[string, string]

Get agent readiness summary

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/radar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.Radar.AgentReadiness.Summary(
    context.TODO(),
    radar.AgentReadinessSummaryParamsDimensionCheck,
    radar.AgentReadinessSummaryParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Meta)
}

{
  "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

{
  "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
}