--- title: Radar --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Radar #### RadarAgent Readiness ##### [Get agent readiness summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/agent_readiness/methods/summary) radar.agent\_readiness.summary(Literal\["CHECK"]dimension, AgentReadinessSummaryParams\*\*kwargs) -> [AgentReadinessSummaryResponse]() GET/radar/agent\_readiness/summary/{dimension} ##### ModelsExpand Collapse

class AgentReadinessSummaryResponse: …

meta: Meta

date: date 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

domain\_categories: List\[MetaDomainCategory] Available domain sub-categories with their scan counts. Use as filter options for the domainCategory parameter.

name: str Sub-category name. Link to this property value: int Number of successfully scanned domains in this sub-category. Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 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 successful\_domains: int Domains successfully scanned (excludes errors). Link to this property total\_domains: int Total domains attempted in the scan. Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.agent_readiness%20%3E%20(model)%20agent_readiness_summary_response%20%3E%20(schema)>) #### RadarAI #### RadarAITo Markdown ##### [Convert uploaded files to Markdown](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/to_markdown/methods/create) Deprecated radar.ai.to\_markdown.create(ToMarkdownCreateParams\*\*kwargs) -> SyncSinglePage\[[ToMarkdownCreateResponse]()] POST/accounts/{account\_id}/ai/tomarkdown ##### ModelsExpand Collapse

class ToMarkdownCreateResponse: …

data: str Link to this property format: str Link to this property mime\_type: str Link to this property name: str Link to this property tokens: str Link to this property

[Link to this property](<#(resource)%20radar.ai.to_markdown%20%3E%20(model)%20to_markdown_create_response%20%3E%20(schema)>) #### RadarAIInference ##### [Get Workers AI inference distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/inference/methods/summary_v2) radar.ai.inference.summary\_v2(Literal\["MODEL", "TASK"]dimension, InferenceSummaryV2Params\*\*kwargs) -> [InferenceSummaryV2Response]() GET/radar/ai/inference/summary/{dimension} ##### [Get time series distribution of Workers AI inference by dimension.](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/inference/methods/timeseries_groups_v2) radar.ai.inference.timeseries\_groups\_v2(Literal\["MODEL", "TASK"]dimension, InferenceTimeseriesGroupsV2Params\*\*kwargs) -> [InferenceTimeseriesGroupsV2Response]() GET/radar/ai/inference/timeseries\_groups/{dimension} ##### ModelsExpand Collapse

class InferenceSummaryV2Response: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property

Link to this property is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.ai.inference%20%3E%20(model)%20inference_summary_v2_response%20%3E%20(schema)>)

class InferenceTimeseriesGroupsV2Response: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ai.inference%20%3E%20(model)%20inference_timeseries_groups_v2_response%20%3E%20(schema)>) #### RadarAIInferenceSummary ##### [Get Workers AI models summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/inference/subresources/summary/methods/model) Deprecated radar.ai.inference.summary.model(SummaryModelParams\*\*kwargs) -> [SummaryModelResponse]() GET/radar/ai/inference/summary/model ##### [Get Workers AI tasks summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/inference/subresources/summary/methods/task) Deprecated radar.ai.inference.summary.task(SummaryTaskParams\*\*kwargs) -> [SummaryTaskResponse]() GET/radar/ai/inference/summary/task ##### ModelsExpand Collapse

class SummaryModelResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.ai.inference.summary%20%3E%20(model)%20summary_model_response%20%3E%20(schema)>)

class SummaryTaskResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.ai.inference.summary%20%3E%20(model)%20summary_task_response%20%3E%20(schema)>) #### RadarAIInferenceTimeseries Groups #### RadarAIInferenceTimeseries GroupsSummary ##### [Get Workers AI models time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/inference/subresources/timeseries_groups/subresources/summary/methods/model) Deprecated radar.ai.inference.timeseries\_groups.summary.model(SummaryModelParams\*\*kwargs) -> [SummaryModelResponse]() GET/radar/ai/inference/timeseries\_groups/model ##### [Get Workers AI tasks time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/inference/subresources/timeseries_groups/subresources/summary/methods/task) Deprecated radar.ai.inference.timeseries\_groups.summary.task(SummaryTaskParams\*\*kwargs) -> [SummaryTaskResponse]() GET/radar/ai/inference/timeseries\_groups/task ##### ModelsExpand Collapse

class SummaryModelResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ai.inference.timeseries_groups.summary%20%3E%20(model)%20summary_model_response%20%3E%20(schema)>)

class SummaryTaskResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ai.inference.timeseries_groups.summary%20%3E%20(model)%20summary_task_response%20%3E%20(schema)>) #### RadarAIBots ##### [Get AI bots HTTP requests distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/bots/methods/summary_v2) radar.ai.bots.summary\_v2(Literal\["USER\_AGENT", "CRAWL\_PURPOSE", "INDUSTRY", 4 more]dimension, BotSummaryV2Params\*\*kwargs) -> [BotSummaryV2Response]() GET/radar/ai/bots/summary/{dimension} ##### [Get AI bots HTTP requests time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/bots/methods/timeseries) radar.ai.bots.timeseries(BotTimeseriesParams\*\*kwargs) -> [BotTimeseriesResponse]() GET/radar/ai/bots/timeseries ##### [Get time series distribution of AI bots HTTP requests by dimension.](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/bots/methods/timeseries_groups) radar.ai.bots.timeseries\_groups(Literal\["USER\_AGENT", "CRAWL\_PURPOSE", "INDUSTRY", 4 more]dimension, BotTimeseriesGroupsParams\*\*kwargs) -> [BotTimeseriesGroupsResponse]() GET/radar/ai/bots/timeseries\_groups/{dimension} ##### ModelsExpand Collapse

class BotSummaryV2Response: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.ai.bots%20%3E%20(model)%20bot_summary_v2_response%20%3E%20(schema)>)

class BotTimeseriesResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

[Link to this property](<#(resource)%20radar.ai.bots%20%3E%20(model)%20bot_timeseries_response%20%3E%20(schema)>)

class BotTimeseriesGroupsResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ai.bots%20%3E%20(model)%20bot_timeseries_groups_response%20%3E%20(schema)>) #### RadarAIBotsSummary ##### [Get AI user agents summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/bots/subresources/summary/methods/user_agent) Deprecated radar.ai.bots.summary.user\_agent(SummaryUserAgentParams\*\*kwargs) -> [SummaryUserAgentResponse]() GET/radar/ai/bots/summary/user\_agent ##### ModelsExpand Collapse

class SummaryUserAgentResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.ai.bots.summary%20%3E%20(model)%20summary_user_agent_response%20%3E%20(schema)>) #### RadarAITimeseries Groups ##### [Get AI user agents time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/timeseries_groups/methods/user_agent) Deprecated radar.ai.timeseries\_groups.user\_agent(TimeseriesGroupUserAgentParams\*\*kwargs) -> [TimeseriesGroupUserAgentResponse]() GET/radar/ai/bots/timeseries\_groups/user\_agent ##### [Get AI bots HTTP requests distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/timeseries_groups/methods/summary) Deprecated radar.ai.timeseries\_groups.summary(Literal\["USER\_AGENT", "CRAWL\_PURPOSE", "INDUSTRY", 4 more]dimension, TimeseriesGroupSummaryParams\*\*kwargs) -> [TimeseriesGroupSummaryResponse]() GET/radar/ai/bots/summary/{dimension} ##### [Get AI bots HTTP requests time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/timeseries_groups/methods/timeseries) Deprecated radar.ai.timeseries\_groups.timeseries(TimeseriesGroupTimeseriesParams\*\*kwargs) -> [TimeseriesGroupTimeseriesResponse]() GET/radar/ai/bots/timeseries ##### [Get time series distribution of AI bots HTTP requests by dimension.](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/timeseries_groups/methods/timeseries_groups) Deprecated radar.ai.timeseries\_groups.timeseries\_groups(Literal\["USER\_AGENT", "CRAWL\_PURPOSE", "INDUSTRY", 4 more]dimension, TimeseriesGroupTimeseriesGroupsParams\*\*kwargs) -> [TimeseriesGroupTimeseriesGroupsResponse]() GET/radar/ai/bots/timeseries\_groups/{dimension} ##### ModelsExpand Collapse

class TimeseriesGroupUserAgentResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ai.timeseries_groups%20%3E%20(model)%20timeseries_group_user_agent_response%20%3E%20(schema)>)

class TimeseriesGroupSummaryResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.ai.timeseries_groups%20%3E%20(model)%20timeseries_group_summary_response%20%3E%20(schema)>)

class TimeseriesGroupTimeseriesResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

[Link to this property](<#(resource)%20radar.ai.timeseries_groups%20%3E%20(model)%20timeseries_group_timeseries_response%20%3E%20(schema)>)

class TimeseriesGroupTimeseriesGroupsResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ai.timeseries_groups%20%3E%20(model)%20timeseries_group_timeseries_groups_response%20%3E%20(schema)>) #### RadarAIMarkdown For Agents ##### [Get AI markdown for agents reduction ratio summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/markdown_for_agents/methods/summary) radar.ai.markdown\_for\_agents.summary(MarkdownForAgentSummaryParams\*\*kwargs) -> [MarkdownForAgentSummaryResponse]() GET/radar/ai/markdown\_for\_agents/summary ##### [Get AI markdown for agents reduction ratio time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/ai/subresources/markdown_for_agents/methods/timeseries) radar.ai.markdown\_for\_agents.timeseries(MarkdownForAgentTimeseriesParams\*\*kwargs) -> [MarkdownForAgentTimeseriesResponse]() GET/radar/ai/markdown\_for\_agents/timeseries ##### ModelsExpand Collapse

class MarkdownForAgentSummaryResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

summary\_0: Summary0

value: str A numeric string that can include decimals and infinity values. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ai.markdown_for_agents%20%3E%20(model)%20markdown_for_agent_summary_response%20%3E%20(schema)>)

class MarkdownForAgentTimeseriesResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

[Link to this property](<#(resource)%20radar.ai.markdown_for_agents%20%3E%20(model)%20markdown_for_agent_timeseries_response%20%3E%20(schema)>) #### RadarCT ##### [Get certificate distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/ct/methods/summary) radar.ct.summary(Literal\["CA", "CA\_OWNER", "DURATION", 11 more]dimension, CTSummaryParams\*\*kwargs) -> [CTSummaryResponse]() GET/radar/ct/summary/{dimension} ##### [Get certificates time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/ct/methods/timeseries) radar.ct.timeseries(CTTimeseriesParams\*\*kwargs) -> [CTTimeseriesResponse]() GET/radar/ct/timeseries ##### [Get time series of certificate distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/ct/methods/timeseries_groups) radar.ct.timeseries\_groups(Literal\["CA", "CA\_OWNER", "DURATION", 11 more]dimension, CTTimeseriesGroupsParams\*\*kwargs) -> [CTTimeseriesGroupsResponse]() GET/radar/ct/timeseries\_groups/{dimension} ##### ModelsExpand Collapse

class CTSummaryResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

summary\_0: Summary0

One of the following: Dict\[str, str] Link to this property

class Summary0UnionMember1: …

rfc6962: str Link to this property static: str Link to this property

Link to this property

class Summary0UnionMember2: …

gt\_121d: str Link to this property gt\_16d\_lte\_31d: str Link to this property gt\_31d\_lte\_91d: str Link to this property gt\_3d\_lte\_16d: str Link to this property gt\_91d\_lte\_121d: str Link to this property lte\_3d: str Link to this property

Link to this property

class Summary0UnionMember3: …

certificate: str Link to this property precertificate: str Link to this property

Link to this property

class Summary0UnionMember4: …

expired: str Link to this property valid: str Link to this property

Link to this property

class Summary0UnionMember5: …

negative: str Link to this property positive: str Link to this property

Link to this property

class Summary0UnionMember6: …

dsa: str Link to this property ecdsa: str Link to this property rsa: str Link to this property

Link to this property

class Summary0UnionMember7: …

domain: str Link to this property extended: str Link to this property organization: str Link to this property unknown: str Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct%20%3E%20(model)%20ct_summary_response%20%3E%20(schema)>)

class CTTimeseriesResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

[Link to this property](<#(resource)%20radar.ct%20%3E%20(model)%20ct_timeseries_response%20%3E%20(schema)>)

class CTTimeseriesGroupsResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

One of the following:

class Serie0UnnamedSchemaRef7826220e105d84352ba1108d9ed88e55: …

timestamps: List\[datetime] Link to this property

Link to this property

class Serie0UnionMember1: …

rfc6962: List\[str] Link to this property static: List\[str] Link to this property

Link to this property

class Serie0UnionMember2: …

gt\_121d: List\[str] Link to this property gt\_16d\_lte\_31d: List\[str] Link to this property gt\_31d\_lte\_91d: List\[str] Link to this property gt\_3d\_lte\_16d: List\[str] Link to this property gt\_91d\_lte\_121d: List\[str] Link to this property lte\_3d: List\[str] Link to this property

Link to this property

class Serie0UnionMember3: …

certificate: List\[str] Link to this property precertificate: List\[str] Link to this property

Link to this property

class Serie0UnionMember4: …

expired: List\[str] Link to this property valid: List\[str] Link to this property

Link to this property

class Serie0UnionMember5: …

negative: List\[str] Link to this property positive: List\[str] Link to this property

Link to this property

class Serie0UnionMember6: …

dsa: List\[str] Link to this property ecdsa: List\[str] Link to this property rsa: List\[str] Link to this property

Link to this property

class Serie0UnionMember7: …

domain: List\[str] Link to this property extended: List\[str] Link to this property organization: List\[str] Link to this property unknown: List\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct%20%3E%20(model)%20ct_timeseries_groups_response%20%3E%20(schema)>) #### RadarCTAuthorities ##### [Get certificate authority details](https://developers.cloudflare.com/api/python/resources/radar/subresources/ct/subresources/authorities/methods/get) radar.ct.authorities.get(strca\_slug, AuthorityGetParams\*\*kwargs) -> [AuthorityGetResponse]() GET/radar/ct/authorities/{ca\_slug} ##### [List certificate authorities](https://developers.cloudflare.com/api/python/resources/radar/subresources/ct/subresources/authorities/methods/list) radar.ct.authorities.list(AuthorityListParams\*\*kwargs) -> [AuthorityListResponse]() GET/radar/ct/authorities ##### ModelsExpand Collapse

class AuthorityGetResponse: …

certificate\_authority: CertificateAuthority

apple\_status: Literal\["INCLUDED", "NOT\_YET\_INCLUDED", "NOT\_INCLUDED", 4 more] The inclusion status of a Certificate Authority (CA) in the trust store.

One of the following: "INCLUDED" Link to this property "NOT\_YET\_INCLUDED" Link to this property "NOT\_INCLUDED" Link to this property "NOT\_BEFORE" Link to this property "REMOVED" Link to this property "DISABLED" Link to this property "BLOCKED" Link to this property

Link to this property authority\_key\_identifier: str The authorityKeyIdentifier value extracted from the certificate PEM. Link to this property

certificate\_record\_type: Literal\["ROOT\_CERTIFICATE", "INTERMEDIATE\_CERTIFICATE"] Specifies the type of certificate in the trust chain.

One of the following: "ROOT\_CERTIFICATE" Link to this property "INTERMEDIATE\_CERTIFICATE" Link to this property

Link to this property

chrome\_status: Literal\["INCLUDED", "NOT\_YET\_INCLUDED", "NOT\_INCLUDED", 4 more] The inclusion status of a Certificate Authority (CA) in the trust store.

microsoft\_status: Literal\["INCLUDED", "NOT\_YET\_INCLUDED", "NOT\_INCLUDED", 4 more] The inclusion status of a Certificate Authority (CA) in the trust store.

Link to this property

mozilla\_status: Literal\["INCLUDED", "NOT\_YET\_INCLUDED", "NOT\_INCLUDED", 4 more] The inclusion status of a Certificate Authority (CA) in the trust store.

Link to this property name: str The full name of the certificate authority (CA). Link to this property owner: str The organization that owns and operates the CA. Link to this property parent\_name: str The name of the parent/root certificate authority that issued this intermediate certificate. Link to this property parent\_sha256\_fingerprint: str The SHA-256 fingerprint of the parent certificate. Link to this property

related: List\[CertificateAuthorityRelated] CAs from the same owner.

certificate\_record\_type: Literal\["ROOT\_CERTIFICATE", "INTERMEDIATE\_CERTIFICATE"] Specifies the type of certificate in the trust chain.

One of the following: "ROOT\_CERTIFICATE" Link to this property "INTERMEDIATE\_CERTIFICATE" Link to this property

Link to this property name: str The full name of the certificate authority (CA). Link to this property

revocation\_status: Literal\["NOT\_REVOKED", "REVOKED", "PARENT\_CERT\_REVOKED"] The current revocation status of a Certificate Authority (CA) certificate.

One of the following: "NOT\_REVOKED" Link to this property "REVOKED" Link to this property "PARENT\_CERT\_REVOKED" Link to this property

Link to this property sha256\_fingerprint: str The SHA-256 fingerprint of the intermediate certificate. Link to this property

Link to this property

revocation\_status: Literal\["NOT\_REVOKED", "REVOKED", "PARENT\_CERT\_REVOKED"] The current revocation status of a Certificate Authority (CA) certificate.

One of the following: "NOT\_REVOKED" Link to this property "REVOKED" Link to this property "PARENT\_CERT\_REVOKED" Link to this property

Link to this property sha256\_fingerprint: str The SHA-256 fingerprint of the intermediate certificate. Link to this property subject\_key\_identifier: str The subjectKeyIdentifier value extracted from the certificate PEM. Link to this property valid\_from: date The start date of the certificate’s validity period (ISO format). formatdate Link to this property valid\_to: date The end date of the certificate’s validity period (ISO format). formatdate Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct.authorities%20%3E%20(model)%20authority_get_response%20%3E%20(schema)>)

class AuthorityListResponse: …

certificate\_authorities: List\[CertificateAuthority]

certificate\_record\_type: Literal\["ROOT\_CERTIFICATE", "INTERMEDIATE\_CERTIFICATE"] Specifies the type of certificate in the trust chain.

One of the following: "ROOT\_CERTIFICATE" Link to this property "INTERMEDIATE\_CERTIFICATE" Link to this property

Link to this property country: str The two-letter ISO country code where the CA organization is based. Link to this property country\_name: str The full country name corresponding to the country code. Link to this property name: str The full name of the certificate authority (CA). Link to this property owner: str The organization that owns and operates the CA. Link to this property parent\_name: str The name of the parent/root certificate authority that issued this intermediate certificate. Link to this property parent\_sha256\_fingerprint: str The SHA-256 fingerprint of the parent certificate. Link to this property

revocation\_status: Literal\["NOT\_REVOKED", "REVOKED", "PARENT\_CERT\_REVOKED"] The current revocation status of a Certificate Authority (CA) certificate.

One of the following: "NOT\_REVOKED" Link to this property "REVOKED" Link to this property "PARENT\_CERT\_REVOKED" Link to this property

Link to this property sha256\_fingerprint: str The SHA-256 fingerprint of the intermediate certificate. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct.authorities%20%3E%20(model)%20authority_list_response%20%3E%20(schema)>) #### RadarCTLogs ##### [Get certificate log details](https://developers.cloudflare.com/api/python/resources/radar/subresources/ct/subresources/logs/methods/get) radar.ct.logs.get(strlog\_slug, LogGetParams\*\*kwargs) -> [LogGetResponse]() GET/radar/ct/logs/{log\_slug} ##### [List certificate logs](https://developers.cloudflare.com/api/python/resources/radar/subresources/ct/subresources/logs/methods/list) radar.ct.logs.list(LogListParams\*\*kwargs) -> [LogListResponse]() GET/radar/ct/logs ##### ModelsExpand Collapse

class LogGetResponse: …

certificate\_log: CertificateLog

api: Literal\["RFC6962", "STATIC"] The API standard that the certificate log follows.

One of the following: "RFC6962" Link to this property "STATIC" Link to this property

Link to this property avg\_throughput: float The average throughput of the CT log, measured in certificates per hour (certs/hour). Link to this property description: str A brief description of the certificate log. Link to this property end\_exclusive: datetime The end date and time for when the log will stop accepting certificates. formatdate-time Link to this property last\_update: datetime Timestamp of the most recent update to the CT log. formatdate-time Link to this property operator: str The organization responsible for operating the certificate log. Link to this property

performance: Optional\[CertificateLogPerformance] Log performance metrics, including averages and per-endpoint details.

endpoints: List\[CertificateLogPerformanceEndpoint]

endpoint: Literal\["add-chain (new)", "add-chain (old)", "add-pre-chain (new)", 4 more] The certificate log endpoint names used in performance metrics.

One of the following: "add-chain (new)" Link to this property "add-chain (old)" Link to this property "add-pre-chain (new)" Link to this property "add-pre-chain (old)" Link to this property "get-entries" Link to this property "get-roots" Link to this property "get-sth" Link to this property

Link to this property response\_time: float Link to this property uptime: float Link to this property

Link to this property

related: List\[CertificateLogRelated] Logs from the same operator.

description: str A brief description of the certificate log. Link to this property end\_exclusive: datetime The end date and time for when the log will stop accepting certificates. formatdate-time Link to this property slug: str A URL-friendly, kebab-case identifier for the certificate log. Link to this property start\_inclusive: datetime The start date and time for when the log starts accepting certificates. formatdate-time Link to this property

state: Literal\["USABLE", "PENDING", "QUALIFIED", 3 more] The current state of the certificate log. More details about log states can be found here: https://googlechrome.github.io/CertificateTransparency/log\_states.html

One of the following: "USABLE" Link to this property "PENDING" Link to this property "QUALIFIED" Link to this property "READ\_ONLY" Link to this property "RETIRED" Link to this property "REJECTED" Link to this property

Link to this property

Link to this property slug: str A URL-friendly, kebab-case identifier for the certificate log. Link to this property start\_inclusive: datetime The start date and time for when the log starts accepting certificates. formatdate-time Link to this property

Link to this property state\_timestamp: datetime Timestamp of when the log state was last updated. formatdate-time Link to this property submittable\_cert\_count: Optional\[str] Number of certificates that are eligible for inclusion to this log but have not been included yet. Based on certificates signed by trusted root CAs within the log’s accepted date range. Link to this property submitted\_cert\_count: Optional\[str] Number of certificates already included in this CT log. Link to this property url: str The URL for the certificate log. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct.logs%20%3E%20(model)%20log_get_response%20%3E%20(schema)>)

class LogListResponse: …

certificate\_logs: List\[CertificateLog]

api: Literal\["RFC6962", "STATIC"] The API standard that the certificate log follows.

One of the following: "RFC6962" Link to this property "STATIC" Link to this property

Link to this property description: str A brief description of the certificate log. Link to this property end\_exclusive: datetime The end date and time for when the log will stop accepting certificates. formatdate-time Link to this property operator: str The organization responsible for operating the certificate log. Link to this property slug: str A URL-friendly, kebab-case identifier for the certificate log. Link to this property start\_inclusive: datetime The start date and time for when the log starts accepting certificates. formatdate-time Link to this property

Link to this property state\_timestamp: datetime Timestamp of when the log state was last updated. formatdate-time Link to this property url: str The URL for the certificate log. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct.logs%20%3E%20(model)%20log_list_response%20%3E%20(schema)>) #### RadarAnnotations ##### [Get latest annotations](https://developers.cloudflare.com/api/python/resources/radar/subresources/annotations/methods/list) radar.annotations.list(AnnotationListParams\*\*kwargs) -> [AnnotationListResponse]() GET/radar/annotations ##### ModelsExpand Collapse

class AnnotationListResponse: …

annotations: List\[Annotation]

id: str Link to this property asns: List\[int] Link to this property

asns\_details: List\[AnnotationASNsDetail]

asn: str Link to this property

location: Optional\[AnnotationASNsDetailLocation]

code: str Link to this property name: str Link to this property

Link to this property name: Optional\[str] Link to this property

Link to this property data\_source: str Link to this property description: Optional\[str] Link to this property end\_date: Optional\[str] Link to this property

entities: List\[AnnotationEntity]

entity\_name: Optional\[str] Link to this property entity\_type: str Link to this property entity\_value: str Link to this property

Link to this property event\_type: str Link to this property geo\_ids: List\[str] Link to this property linked\_url: Optional\[str] Link to this property locations: List\[str] Link to this property

locations\_details: List\[Optional\[AnnotationLocationsDetail]]

code: str Link to this property name: str Link to this property

Link to this property origins: List\[str] Link to this property

origins\_details: List\[AnnotationOriginsDetail]

Link to this property

outage: Optional\[AnnotationOutage]

outage\_cause: str Link to this property outage\_type: str Link to this property

Link to this property scope: Optional\[str] Link to this property start\_date: str Link to this property tags: List\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)>) #### RadarAnnotationsOutages ##### [Get latest Internet outages and anomalies](https://developers.cloudflare.com/api/python/resources/radar/subresources/annotations/subresources/outages/methods/get) radar.annotations.outages.get(OutageGetParams\*\*kwargs) -> [OutageGetResponse]() GET/radar/annotations/outages ##### [Get the number of outages by location](https://developers.cloudflare.com/api/python/resources/radar/subresources/annotations/subresources/outages/methods/locations) radar.annotations.outages.locations(OutageLocationsParams\*\*kwargs) -> [OutageLocationsResponse]() GET/radar/annotations/outages/locations ##### ModelsExpand Collapse

class OutageGetResponse: …

annotations: List\[Annotation]

id: str Link to this property asns: List\[int] Link to this property

asns\_details: List\[AnnotationASNsDetail]

asn: str Link to this property

location: Optional\[AnnotationASNsDetailLocation]

code: str Link to this property name: str Link to this property

Link to this property name: Optional\[str] Link to this property

Link to this property data\_source: str Link to this property description: Optional\[str] Link to this property end\_date: Optional\[datetime] formatdate-time Link to this property

entities: List\[AnnotationEntity]

entity\_name: Optional\[str] Link to this property entity\_type: str Link to this property entity\_value: str Link to this property

Link to this property event\_type: str Link to this property geo\_ids: List\[str] Link to this property linked\_url: Optional\[str] Link to this property locations: List\[str] Link to this property

locations\_details: List\[Optional\[AnnotationLocationsDetail]]

code: str Link to this property name: str Link to this property

Link to this property origins: List\[str] Link to this property

origins\_details: List\[AnnotationOriginsDetail]

Link to this property

outage: Optional\[AnnotationOutage]

outage\_cause: str Link to this property outage\_type: str Link to this property

Link to this property scope: Optional\[str] Link to this property start\_date: datetime formatdate-time Link to this property tags: List\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)>)

class OutageLocationsResponse: …

annotations: List\[Annotation]

client\_country\_alpha2: str Link to this property client\_country\_name: str Link to this property value: str A numeric string. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_locations_response%20%3E%20(schema)>) #### RadarBGP ##### [Get BGP time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/methods/timeseries) radar.bgp.timeseries(BGPTimeseriesParams\*\*kwargs) -> [BGPTimeseriesResponse]() GET/radar/bgp/timeseries ##### ModelsExpand Collapse

class BGPTimeseriesResponse: …

meta: Meta

agg\_interval: Literal\["15m", "1h", "1d", "1w"]

One of the following: "15m" Link to this property "1h" Link to this property "1d" Link to this property "1w" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime formatdate-time Link to this property

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property values: List\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp%20%3E%20(model)%20bgp_timeseries_response%20%3E%20(schema)>) #### RadarBGPLeaks #### RadarBGPLeaksEvents ##### [Get BGP route leak events](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/leaks/subresources/events/methods/list) radar.bgp.leaks.events.list(EventListParams\*\*kwargs) -> SyncV4PagePagination\[[EventListResponse]()] GET/radar/bgp/leaks/events ##### ModelsExpand Collapse

class EventListResponse: …

asn\_info: List\[ASNInfo]

asn: int Link to this property country\_code: str Link to this property org\_name: str Link to this property

Link to this property

events: List\[Event]

id: int Link to this property countries: List\[str] Link to this property detected\_ts: str Link to this property finished: bool Link to this property leak\_asn: int Link to this property leak\_count: int Link to this property leak\_seg: List\[int] Link to this property leak\_type: int Link to this property max\_ts: str Link to this property min\_ts: str Link to this property origin\_count: int Link to this property peer\_count: int Link to this property prefix\_count: int Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.leaks.events%20%3E%20(model)%20event_list_response%20%3E%20(schema)>) #### RadarBGPTop ##### [Get top prefixes by BGP updates](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/top/methods/prefixes) radar.bgp.top.prefixes(TopPrefixesParams\*\*kwargs) -> [TopPrefixesResponse]() GET/radar/bgp/top/prefixes ##### ModelsExpand Collapse

class TopPrefixesResponse: …

meta: Meta

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property

top\_0: List\[Top0]

prefix: str Link to this property value: str A numeric string. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.top%20%3E%20(model)%20top_prefixes_response%20%3E%20(schema)>) #### RadarBGPTopAses ##### [Get top ASes by BGP updates](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/top/subresources/ases/methods/get) radar.bgp.top.ases.get(AseGetParams\*\*kwargs) -> [AseGetResponse]() GET/radar/bgp/top/ases ##### [Get top ASes by prefix count](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/top/subresources/ases/methods/prefixes) radar.bgp.top.ases.prefixes(AsePrefixesParams\*\*kwargs) -> [AsePrefixesResponse]() GET/radar/bgp/top/ases/prefixes ##### ModelsExpand Collapse

class AseGetResponse: …

meta: Meta

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property

top\_0: List\[Top0]

asn: int Link to this property as\_name: str Link to this property value: str Percentage of updates by this AS out of the total updates by all autonomous systems. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.top.ases%20%3E%20(model)%20ase_get_response%20%3E%20(schema)>)

class AsePrefixesResponse: …

asns: List\[ASN]

asn: int Link to this property country: str Link to this property name: str Link to this property pfxs\_count: int Link to this property

Link to this property

meta: Meta

data\_time: str Link to this property query\_time: str Link to this property total\_peers: int Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.top.ases%20%3E%20(model)%20ase_prefixes_response%20%3E%20(schema)>) #### RadarBGPHijacks #### RadarBGPHijacksEvents ##### [Get BGP hijack events](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/hijacks/subresources/events/methods/list) radar.bgp.hijacks.events.list(EventListParams\*\*kwargs) -> SyncV4PagePagination\[[EventListResponse]()] GET/radar/bgp/hijacks/events ##### ModelsExpand Collapse

class EventListResponse: …

asn\_info: List\[ASNInfo]

asn: int Link to this property country\_code: str Link to this property org\_name: str Link to this property

Link to this property

events: List\[Event]

id: int Link to this property confidence\_score: int Link to this property duration: int Link to this property event\_type: int Link to this property hijack\_msgs\_count: int Link to this property hijacker\_asn: int Link to this property hijacker\_country: str Link to this property is\_stale: bool Link to this property max\_hijack\_ts: str Link to this property max\_msg\_ts: str Link to this property min\_hijack\_ts: str Link to this property on\_going\_count: int Link to this property peer\_asns: List\[int] Link to this property peer\_ip\_count: int Link to this property prefixes: List\[str] Link to this property

tags: List\[EventTag]

Link to this property victim\_asns: List\[int] Link to this property victim\_countries: List\[str] Link to this property

Link to this property total\_monitors: int Link to this property

[Link to this property](<#(resource)%20radar.bgp.hijacks.events%20%3E%20(model)%20event_list_response%20%3E%20(schema)>) #### RadarBGPRoutes ##### [Get Multi-Origin AS (MOAS) prefixes](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/routes/methods/moas) radar.bgp.routes.moas(RouteMoasParams\*\*kwargs) -> [RouteMoasResponse]() GET/radar/bgp/routes/moas ##### [Get prefix-to-ASN mapping](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/routes/methods/pfx2as) radar.bgp.routes.pfx2as(RoutePfx2asParams\*\*kwargs) -> [RoutePfx2asResponse]() GET/radar/bgp/routes/pfx2as ##### [Get BGP routing table stats](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/routes/methods/stats) radar.bgp.routes.stats(RouteStatsParams\*\*kwargs) -> [RouteStatsResponse]() GET/radar/bgp/routes/stats ##### [List ASes from global routing tables](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/routes/methods/ases) radar.bgp.routes.ases(RouteAsesParams\*\*kwargs) -> [RouteAsesResponse]() GET/radar/bgp/routes/ases ##### [Get real-time BGP routes for a prefix](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/routes/methods/realtime) radar.bgp.routes.realtime(RouteRealtimeParams\*\*kwargs) -> [RouteRealtimeResponse]() GET/radar/bgp/routes/realtime ##### ModelsExpand Collapse

class RouteMoasResponse: …

meta: Meta

data\_time: str Link to this property query\_time: str Link to this property total\_peers: int Link to this property

Link to this property

moas: List\[Moa]

origins: List\[MoaOrigin]

origin: int Link to this property peer\_count: int Link to this property rpki\_validation: str Link to this property

Link to this property prefix: str Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.routes%20%3E%20(model)%20route_moas_response%20%3E%20(schema)>)

class RoutePfx2asResponse: …

meta: Meta

data\_time: str Link to this property query\_time: str Link to this property total\_peers: int Link to this property

Link to this property

prefix\_origins: List\[PrefixOrigin]

origin: int Link to this property peer\_count: int Link to this property prefix: str Link to this property rpki\_validation: str Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.routes%20%3E%20(model)%20route_pfx2as_response%20%3E%20(schema)>)

class RouteStatsResponse: …

meta: Meta

data\_time: str Link to this property query\_time: str Link to this property total\_peers: int Link to this property

Link to this property

stats: Stats

distinct\_origins: int Link to this property distinct\_origins\_ipv4: int Link to this property distinct\_origins\_ipv6: int Link to this property distinct\_prefixes: int Link to this property distinct\_prefixes\_ipv4: int Link to this property distinct\_prefixes\_ipv6: int Link to this property routes\_invalid: int Link to this property routes\_invalid\_ipv4: int Link to this property routes\_invalid\_ipv6: int Link to this property routes\_total: int Link to this property routes\_total\_ipv4: int Link to this property routes\_total\_ipv6: int Link to this property routes\_unknown: int Link to this property routes\_unknown\_ipv4: int Link to this property routes\_unknown\_ipv6: int Link to this property routes\_valid: int Link to this property routes\_valid\_ipv4: int Link to this property routes\_valid\_ipv6: int Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.routes%20%3E%20(model)%20route_stats_response%20%3E%20(schema)>)

class RouteAsesResponse: …

asns: List\[ASN]

asn: int Link to this property cone\_size: int AS’s customer cone size. Link to this property country: str Alpha-2 code for the AS’s registration country. Link to this property ipv4\_count: int Number of IPv4 addresses originated by the AS. Link to this property ipv6\_count: str Number of IPv6 addresses originated by the AS. Link to this property name: str Name of the AS. Link to this property pfxs\_count: int Number of total IP prefixes originated by the AS. Link to this property rpki\_invalid: int Number of RPKI invalid prefixes originated by the AS. Link to this property rpki\_unknown: int Number of RPKI unknown prefixes originated by the AS. Link to this property rpki\_valid: int Number of RPKI valid prefixes originated by the AS. Link to this property

Link to this property

meta: Meta

data\_time: str The timestamp of when the data is generated. Link to this property query\_time: str The timestamp of the query. Link to this property total\_peers: int Total number of route collector peers used to generate this data. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.routes%20%3E%20(model)%20route_ases_response%20%3E%20(schema)>)

class RouteRealtimeResponse: …

meta: Meta

asn\_info: List\[MetaASNInfo]

as\_name: str Name of the autonomous system. Link to this property asn: int AS number. Link to this property country\_code: str Alpha-2 code for the AS’s registration country. Link to this property org\_id: str Organization ID. Link to this property org\_name: str Organization name. Link to this property

Link to this property

collectors: List\[MetaCollector]

collector: str Public route collector ID. Link to this property latest\_realtime\_ts: str Latest real-time stream timestamp for this collector. Link to this property latest\_rib\_ts: str Latest RIB dump MRT file timestamp for this collector. Link to this property latest\_updates\_ts: str Latest BGP updates MRT file timestamp for this collector. Link to this property peers\_count: int Total number of collector peers used from this collector. Link to this property peers\_v4\_count: int Total number of collector peers used from this collector for IPv4 prefixes. Link to this property peers\_v6\_count: int Total number of collector peers used from this collector for IPv6 prefixes. Link to this property

Link to this property data\_time: str The most recent data timestamp for from the real-time sources. Link to this property

prefix\_origins: List\[MetaPrefixOrigin]

origin: int Origin ASN. Link to this property prefix: str IP prefix of this query. Link to this property rpki\_validation: str Prefix-origin RPKI validation: valid, invalid, unknown. Link to this property total\_peers: int Total number of peers. Link to this property total\_visible: int Total number of peers seeing this prefix. Link to this property visibility: float Ratio of peers seeing this prefix to total number of peers. Link to this property

Link to this property query\_time: str The timestamp of this query. Link to this property

Link to this property

routes: List\[Route]

as\_path: List\[int] AS-level path for this route, from collector to origin. Link to this property collector: str Public collector ID for this route. Link to this property communities: List\[str] BGP community values. Link to this property prefix: str IP prefix of this query. Link to this property timestamp: str Latest timestamp of change for this route. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.routes%20%3E%20(model)%20route_realtime_response%20%3E%20(schema)>) #### RadarBGPRoutesUpstreams ##### [Get upstream composition time series for an AS](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/routes/subresources/upstreams/methods/timeseries) radar.bgp.routes.upstreams.timeseries(intasn, UpstreamTimeseriesParams\*\*kwargs) -> [UpstreamTimeseriesResponse]() GET/radar/bgp/routes/upstreams/{asn}/timeseries ##### ModelsExpand Collapse

class UpstreamTimeseriesResponse: …

meta: Meta

data\_time: Optional\[datetime] Timestamp of the underlying RIB data. formatdate-time Link to this property effective\_collector: Optional\[str] Link to this property query\_time: Optional\[datetime] Timestamp when the query was executed. formatdate-time Link to this property stale: bool Link to this property

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.routes.upstreams%20%3E%20(model)%20upstream_timeseries_response%20%3E%20(schema)>) #### RadarBGPRoutesPaths ##### [Get tier-1 path segments for an AS](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/routes/subresources/paths/methods/list) radar.bgp.routes.paths.list(intasn, PathListParams\*\*kwargs) -> [PathListResponse]() GET/radar/bgp/routes/paths/{asn} ##### ModelsExpand Collapse

class PathListResponse: …

asn\_info: Optional\[Dict\[str, ASNInfo]]

asn: int ASN number. Link to this property country: Optional\[str] Alpha-2 country code. Link to this property name: Optional\[str] AS name. Link to this property

Link to this property collectors: List\[str] Link to this property

meta: Meta

Link to this property

paths: List\[Path]

collectors: List\[str] Link to this property paths\_count: int Link to this property peers\_count: int Link to this property segment: List\[int] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.routes.paths%20%3E%20(model)%20path_list_response%20%3E%20(schema)>) #### RadarBGPIPs ##### [Get announced IP address space time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/ips/methods/timeseries) radar.bgp.ips.timeseries(IPTimeseriesParams\*\*kwargs) -> [IPTimeseriesResponse]() GET/radar/bgp/ips/timeseries ##### ModelsExpand Collapse

class IPTimeseriesResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

delay: Optional\[MetaDelay]

asn\_data: MetaDelayASNData

delay\_secs: float Link to this property delay\_str: str Link to this property healthy: bool Link to this property

latest: MetaDelayASNDataLatest

entries\_count: float Link to this property path: str Link to this property timestamp: float Link to this property

Link to this property

country\_data: MetaDelayCountryData

delay\_secs: float Link to this property delay\_str: str Link to this property healthy: bool Link to this property

latest: MetaDelayCountryDataLatest

Link to this property

Link to this property healthy: bool Link to this property now\_ts: float Link to this property

Link to this property

serie\_0: Serie0

ipv4: List\[str] Link to this property ipv6: List\[str] Link to this property timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.ips%20%3E%20(model)%20ip_timeseries_response%20%3E%20(schema)>) #### RadarBGPIPsTop ##### [Get top ASes by announced IP space](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/ips/subresources/top/methods/ases) radar.bgp.ips.top.ases(TopAsesParams\*\*kwargs) -> [TopAsesResponse]() GET/radar/bgp/ips/top/ases ##### ModelsExpand Collapse

class TopAsesResponse: …

anchor\_ts: datetime formatdate-time Link to this property

asns: List\[ASN]

asn: int Link to this property v4\_24s: int Link to this property v6\_48s: int Link to this property

Link to this property country: Optional\[str] Link to this property metric: str Link to this property

[Link to this property](<#(resource)%20radar.bgp.ips.top%20%3E%20(model)%20top_ases_response%20%3E%20(schema)>) #### RadarBGPRPKI #### RadarBGPRPKIASPA ##### [Get ASPA objects snapshot](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/rpki/subresources/aspa/methods/snapshot) radar.bgp.rpki.aspa.snapshot(ASPASnapshotParams\*\*kwargs) -> [ASPASnapshotResponse]() GET/radar/bgp/rpki/aspa/snapshot ##### [Get ASPA changes over time](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/rpki/subresources/aspa/methods/changes) radar.bgp.rpki.aspa.changes(ASPAChangesParams\*\*kwargs) -> [ASPAChangesResponse]() GET/radar/bgp/rpki/aspa/changes ##### [Get ASPA count time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/rpki/subresources/aspa/methods/timeseries) radar.bgp.rpki.aspa.timeseries(ASPATimeseriesParams\*\*kwargs) -> [ASPATimeseriesResponse]() GET/radar/bgp/rpki/aspa/timeseries ##### ModelsExpand Collapse

class ASPASnapshotResponse: …

asn\_info: ASNInfo

\_13335: ASNInfo\_13335

asn: int ASN number. Link to this property country: str Alpha-2 country code. Link to this property name: str AS name. Link to this property

Link to this property

aspa\_objects: List\[ASPAObject]

customer\_asn: int The customer ASN publishing the ASPA object. Link to this property providers: List\[int] Link to this property

Link to this property

meta: Meta

data\_time: datetime Timestamp of the underlying data. formatdate-time Link to this property query\_time: datetime Timestamp when the query was executed. formatdate-time Link to this property total\_count: int Total number of ASPA objects. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.rpki.aspa%20%3E%20(model)%20aspa_snapshot_response%20%3E%20(schema)>)

class ASPAChangesResponse: …

asn\_info: ASNInfo

\_13335: ASNInfo\_13335

asn: int ASN number. Link to this property country: str Alpha-2 country code. Link to this property name: str AS name. Link to this property

Link to this property

changes: List\[Change]

customers\_added: int Number of new ASPA objects created. Link to this property customers\_removed: int Number of ASPA objects deleted. Link to this property date: datetime Date of the changes in ISO 8601 format. formatdate-time Link to this property

entries: List\[ChangeEntry]

customer\_asn: int The customer ASN affected. Link to this property providers: List\[int] Link to this property

type: Literal\["CustomerAdded", "CustomerRemoved", "ProvidersAdded", "ProvidersRemoved"]

One of the following: "CustomerAdded" Link to this property "CustomerRemoved" Link to this property "ProvidersAdded" Link to this property "ProvidersRemoved" Link to this property

Link to this property

Link to this property providers\_added: int Number of providers added to existing objects. Link to this property providers\_removed: int Number of providers removed from existing objects. Link to this property total\_count: int Running total of active ASPA objects after this day. Link to this property

Link to this property

meta: Meta

data\_time: datetime Timestamp of the underlying data. formatdate-time Link to this property query\_time: datetime Timestamp when the query was executed. formatdate-time Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.rpki.aspa%20%3E%20(model)%20aspa_changes_response%20%3E%20(schema)>)

class ASPATimeseriesResponse: …

meta: Meta

data\_time: datetime Timestamp of the underlying data. formatdate-time Link to this property query\_time: datetime Timestamp when the query was executed. formatdate-time Link to this property

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property values: List\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.rpki.aspa%20%3E%20(model)%20aspa_timeseries_response%20%3E%20(schema)>) #### RadarBGPRPKIRoas ##### [Get RPKI ROA deployment time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/bgp/subresources/rpki/subresources/roas/methods/timeseries) radar.bgp.rpki.roas.timeseries(RoaTimeseriesParams\*\*kwargs) -> [RoaTimeseriesResponse]() GET/radar/bgp/rpki/roas/timeseries ##### ModelsExpand Collapse

class RoaTimeseriesResponse: …

meta: Meta

data\_time: datetime Timestamp of the underlying data. formatdate-time Link to this property query\_time: datetime Timestamp when the query was executed. formatdate-time Link to this property

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property values: List\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bgp.rpki.roas%20%3E%20(model)%20roa_timeseries_response%20%3E%20(schema)>) #### RadarBots ##### [List bots](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/list) radar.bots.list(BotListParams\*\*kwargs) -> [BotListResponse]() GET/radar/bots ##### [Get bot details](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/get) radar.bots.get(strbot\_slug, BotGetParams\*\*kwargs) -> [BotGetResponse]() GET/radar/bots/{bot\_slug} ##### [Get bots HTTP requests distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/summary) radar.bots.summary(Literal\["BOT", "BOT\_KIND", "BOT\_OPERATOR", "BOT\_CATEGORY"]dimension, BotSummaryParams\*\*kwargs) -> [BotSummaryResponse]() GET/radar/bots/summary/{dimension} ##### [Get bots HTTP requests time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/timeseries) radar.bots.timeseries(BotTimeseriesParams\*\*kwargs) -> [BotTimeseriesResponse]() GET/radar/bots/timeseries ##### [Get time series distribution of bots HTTP requests by dimension.](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/timeseries_groups) radar.bots.timeseries\_groups(Literal\["BOT", "BOT\_KIND", "BOT\_OPERATOR", "BOT\_CATEGORY"]dimension, BotTimeseriesGroupsParams\*\*kwargs) -> [BotTimeseriesGroupsResponse]() GET/radar/bots/timeseries\_groups/{dimension} ##### ModelsExpand Collapse

class BotListResponse: …

bots: List\[Bot]

Link to this property

[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_list_response%20%3E%20(schema)>)

class BotGetResponse: …

bot: Bot

category: str The category of the bot. Link to this property description: str A summary for the bot (e.g., purpose). Link to this property Deprecatedkind: str The kind of the bot. Link to this property name: str The name of the bot. Link to this property operator: str The organization that owns and operates the bot. Link to this property operator\_url: str The link to the bot documentation. Link to this property slug: str A kebab-case identifier derived from the bot name. Link to this property user\_agent\_patterns: List\[str] Link to this property user\_agents: List\[str] Link to this property signature\_agent\_url: Optional\[str] The URL of the agent’s Web Bot Auth resource. Null for bots not verified via request signature. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_get_response%20%3E%20(schema)>)

class BotSummaryResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_summary_response%20%3E%20(schema)>)

class BotTimeseriesResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_timeseries_response%20%3E%20(schema)>)

class BotTimeseriesGroupsResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_timeseries_groups_response%20%3E%20(schema)>) #### RadarBotsWeb Crawlers ##### [Get crawler HTTP request distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/subresources/web_crawlers/methods/summary) radar.bots.web\_crawlers.summary(Literal\["CLIENT\_TYPE", "USER\_AGENT", "REFERER", 5 more]dimension, WebCrawlerSummaryParams\*\*kwargs) -> [WebCrawlerSummaryResponse]() GET/radar/bots/crawlers/summary/{dimension} ##### [Get time series of crawler HTTP request distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/subresources/web_crawlers/methods/timeseries_groups) radar.bots.web\_crawlers.timeseries\_groups(Literal\["CLIENT\_TYPE", "USER\_AGENT", "REFERER", 5 more]dimension, WebCrawlerTimeseriesGroupsParams\*\*kwargs) -> [WebCrawlerTimeseriesGroupsResponse]() GET/radar/bots/crawlers/timeseries\_groups/{dimension} ##### ModelsExpand Collapse

class WebCrawlerSummaryResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.bots.web_crawlers%20%3E%20(model)%20web_crawler_summary_response%20%3E%20(schema)>)

class WebCrawlerTimeseriesGroupsResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.bots.web_crawlers%20%3E%20(model)%20web_crawler_timeseries_groups_response%20%3E%20(schema)>) #### RadarDatasets ##### [List datasets](https://developers.cloudflare.com/api/python/resources/radar/subresources/datasets/methods/list) radar.datasets.list(DatasetListParams\*\*kwargs) -> [DatasetListResponse]() GET/radar/datasets ##### [Get dataset CSV stream](https://developers.cloudflare.com/api/python/resources/radar/subresources/datasets/methods/get) radar.datasets.get(stralias) -> [DatasetGetResponse]() GET/radar/datasets/{alias} ##### [Get dataset download URL](https://developers.cloudflare.com/api/python/resources/radar/subresources/datasets/methods/download) radar.datasets.download(DatasetDownloadParams\*\*kwargs) -> [DatasetDownloadResponse]() POST/radar/datasets/download ##### ModelsExpand Collapse

class DatasetListResponse: …

datasets: List\[Dataset]

id: int Link to this property description: str Link to this property meta: object Link to this property tags: List\[str] Link to this property title: str Link to this property type: str Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.datasets%20%3E%20(model)%20dataset_list_response%20%3E%20(schema)>) str [Link to this property](<#(resource)%20radar.datasets%20%3E%20(model)%20dataset_get_response%20%3E%20(schema)>)

class DatasetDownloadResponse: …

dataset: Dataset

url: str Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.datasets%20%3E%20(model)%20dataset_download_response%20%3E%20(schema)>) #### RadarDNS ##### [Get DNS summary by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/methods/summary_v2) radar.dns.summary\_v2(Literal\["AS", "CACHE\_HIT", "DNSSEC", 11 more]dimension, DNSSummaryV2Params\*\*kwargs) -> [DNSSummaryV2Response]() GET/radar/dns/summary/{dimension} ##### [Get DNS queries time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/methods/timeseries) radar.dns.timeseries(DNSTimeseriesParams\*\*kwargs) -> [DNSTimeseriesResponse]() GET/radar/dns/timeseries ##### [Get DNS time series grouped by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/methods/timeseries_groups_v2) radar.dns.timeseries\_groups\_v2(Literal\["AS", "CACHE\_HIT", "DNSSEC", 11 more]dimension, DNSTimeseriesGroupsV2Params\*\*kwargs) -> [DNSTimeseriesGroupsV2Response]() GET/radar/dns/timeseries\_groups/{dimension} ##### ModelsExpand Collapse

class DNSSummaryV2Response: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

Link to this property summary\_0: Dict\[str, str] Link to this property

[Link to this property](<#(resource)%20radar.dns%20%3E%20(model)%20dns_summary_v2_response%20%3E%20(schema)>)

class DNSTimeseriesResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

[Link to this property](<#(resource)%20radar.dns%20%3E%20(model)%20dns_timeseries_response%20%3E%20(schema)>)

class DNSTimeseriesGroupsV2Response: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

serie\_0: Serie0

timestamps: List\[datetime] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.dns%20%3E%20(model)%20dns_timeseries_groups_v2_response%20%3E%20(schema)>) #### RadarDNSTop ##### [Get top ASes by DNS queries](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/top/methods/ases) radar.dns.top.ases(TopAsesParams\*\*kwargs) -> [TopAsesResponse]() GET/radar/dns/top/ases ##### [Get top locations by DNS queries](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/top/methods/locations) radar.dns.top.locations(TopLocationsParams\*\*kwargs) -> [TopLocationsResponse]() GET/radar/dns/top/locations ##### ModelsExpand Collapse

class TopAsesResponse: …

meta: Meta Metadata for the results.

confidence\_info: Optional\[MetaConfidenceInfo]

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

top\_0: List\[Top0]

client\_asn: int Link to this property client\_as\_name: str Link to this property value: str A numeric string. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.dns.top%20%3E%20(model)%20top_ases_response%20%3E%20(schema)>)

class TopLocationsResponse: …

meta: Meta Metadata for the results.

confidence\_info: Optional\[MetaConfidenceInfo]

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

Link to this property

units: List\[MetaUnit] Measurement units for the results.

Link to this property

top\_0: List\[Top0]

client\_country\_alpha2: str Link to this property client\_country\_name: str Link to this property value: str A numeric string. Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.dns.top%20%3E%20(model)%20top_locations_response%20%3E%20(schema)>) #### RadarDNSSummary ##### [Get DNS queries by cache status summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/cache_hit) Deprecated radar.dns.summary.cache\_hit(SummaryCacheHitParams\*\*kwargs) -> [SummaryCacheHitResponse]() GET/radar/dns/summary/cache\_hit ##### [Get DNS queries by DNSSEC support summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/dnssec) Deprecated radar.dns.summary.dnssec(SummaryDNSSECParams\*\*kwargs) -> [SummaryDNSSECResponse]() GET/radar/dns/summary/dnssec ##### [Get DNS queries by DNSSEC awareness summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/dnssec_aware) Deprecated radar.dns.summary.dnssec\_aware(SummaryDNSSECAwareParams\*\*kwargs) -> [SummaryDNSSECAwareResponse]() GET/radar/dns/summary/dnssec\_aware ##### [Get DNS queries by DNSSEC end-to-end summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/dnssec_e2e) Deprecated radar.dns.summary.dnssec\_e2e(SummaryDNSSECE2EParams\*\*kwargs) -> [SummaryDNSSECE2EResponse]() GET/radar/dns/summary/dnssec\_e2e ##### [Get DNS queries by IP version summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/ip_version) Deprecated radar.dns.summary.ip\_version(SummaryIPVersionParams\*\*kwargs) -> [SummaryIPVersionResponse]() GET/radar/dns/summary/ip\_version ##### [Get DNS queries by matching answer summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/matching_answer) Deprecated radar.dns.summary.matching\_answer(SummaryMatchingAnswerParams\*\*kwargs) -> [SummaryMatchingAnswerResponse]() GET/radar/dns/summary/matching\_answer ##### [Get DNS queries by protocol summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/protocol) Deprecated radar.dns.summary.protocol(SummaryProtocolParams\*\*kwargs) -> [SummaryProtocolResponse]() GET/radar/dns/summary/protocol ##### [Get DNS queries by type summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/query_type) Deprecated radar.dns.summary.query\_type(SummaryQueryTypeParams\*\*kwargs) -> [SummaryQueryTypeResponse]() GET/radar/dns/summary/query\_type ##### [Get DNS queries by response code summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/response_code) Deprecated radar.dns.summary.response\_code(SummaryResponseCodeParams\*\*kwargs) -> [SummaryResponseCodeResponse]() GET/radar/dns/summary/response\_code ##### [Get DNS queries by response TTL summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/summary/methods/response_ttl) Deprecated radar.dns.summary.response\_ttl(SummaryResponseTTLParams\*\*kwargs) -> [SummaryResponseTTLResponse]() GET/radar/dns/summary/response\_ttl ##### ModelsExpand Collapse

class SummaryCacheHitResponse: …

meta: Meta Metadata for the results.

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.