---
title: Annotations
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

[Radar](https://developers.cloudflare.com/api/python/resources/radar)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Annotations

##### [Get latest annotations](https://developers.cloudflare.com/api/python/resources/radar/subresources/annotations/methods/list)

radar.annotations.list(AnnotationListParams\*\*kwargs) -> [AnnotationListResponse](<https://developers.cloudflare.com/api/python/resources/radar#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)>)

GET/radar/annotations

##### ModelsExpand Collapse

<details>

<summary>

class AnnotationListResponse: …

</summary>

<details>

<summary>

annotations: List\[Annotation]

</summary>

id: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20id">Link to this property</a>

asns: List\[int]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asns">Link to this property</a>

<details>

<summary>

asns\_details: List\[AnnotationASNsDetail]

</summary>

asn: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20asn">Link to this property</a>

<details>

<summary>

location: Optional\[AnnotationASNsDetailLocation]

</summary>

code: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20location%20%3E%20(property)%20code">Link to this property</a>

name: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20location%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20location">Link to this property</a>

name: Optional\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails">Link to this property</a>

data\_source: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20dataSource">Link to this property</a>

description: Optional\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20description">Link to this property</a>

end\_date: Optional\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20endDate">Link to this property</a>

<details>

<summary>

entities: List\[AnnotationEntity]

</summary>

entity\_name: Optional\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities%20%3E%20(items)%20%3E%20(property)%20entityName">Link to this property</a>

entity\_type: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities%20%3E%20(items)%20%3E%20(property)%20entityType">Link to this property</a>

entity\_value: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities%20%3E%20(items)%20%3E%20(property)%20entityValue">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities">Link to this property</a>

event\_type: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20eventType">Link to this property</a>

geo\_ids: List\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20geoIds">Link to this property</a>

linked\_url: Optional\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20linkedUrl">Link to this property</a>

locations: List\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locations">Link to this property</a>

<details>

<summary>

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

</summary>

code: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locationsDetails%20%3E%20(items)%20%3E%20(property)%20code">Link to this property</a>

name: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locationsDetails%20%3E%20(items)%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locationsDetails">Link to this property</a>

origins: List\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20origins">Link to this property</a>

<details>

<summary>

origins\_details: List\[AnnotationOriginsDetail]

</summary>

name: Optional\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20originsDetails%20%3E%20(items)%20%3E%20(property)%20name">Link to this property</a>

origin: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20originsDetails%20%3E%20(items)%20%3E%20(property)%20origin">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20originsDetails">Link to this property</a>

<details>

<summary>

outage: Optional\[AnnotationOutage]

</summary>

outage\_cause: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20outage%20%3E%20(property)%20outageCause">Link to this property</a>

outage\_type: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20outage%20%3E%20(property)%20outageType">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20outage">Link to this property</a>

scope: Optional\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20scope">Link to this property</a>

start\_date: str

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20startDate">Link to this property</a>

tags: List\[str]

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20tags">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations%20%3E%20(model)%20annotation_list_response%20%3E%20(schema)%20%3E%20(property)%20annotations">Link to this property</a>

</details>

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

#### AnnotationsOutages

##### [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](<https://developers.cloudflare.com/api/python/resources/radar#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)>)

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](<https://developers.cloudflare.com/api/python/resources/radar#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_locations_response%20%3E%20(schema)>)

GET/radar/annotations/outages/locations

##### ModelsExpand Collapse

<details>

<summary>

class OutageGetResponse: …

</summary>

<details>

<summary>

annotations: List\[Annotation]

</summary>

id: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20id">Link to this property</a>

asns: List\[int]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asns">Link to this property</a>

<details>

<summary>

asns\_details: List\[AnnotationASNsDetail]

</summary>

asn: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20asn">Link to this property</a>

<details>

<summary>

location: Optional\[AnnotationASNsDetailLocation]

</summary>

code: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20location%20%3E%20(property)%20code">Link to this property</a>

name: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20location%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20location">Link to this property</a>

name: Optional\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails%20%3E%20(items)%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20asnsDetails">Link to this property</a>

data\_source: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20dataSource">Link to this property</a>

description: Optional\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20description">Link to this property</a>

end\_date: Optional\[datetime]

formatdate-time

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20endDate">Link to this property</a>

<details>

<summary>

entities: List\[AnnotationEntity]

</summary>

entity\_name: Optional\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities%20%3E%20(items)%20%3E%20(property)%20entityName">Link to this property</a>

entity\_type: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities%20%3E%20(items)%20%3E%20(property)%20entityType">Link to this property</a>

entity\_value: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities%20%3E%20(items)%20%3E%20(property)%20entityValue">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20entities">Link to this property</a>

event\_type: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20eventType">Link to this property</a>

geo\_ids: List\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20geoIds">Link to this property</a>

linked\_url: Optional\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20linkedUrl">Link to this property</a>

locations: List\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locations">Link to this property</a>

<details>

<summary>

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

</summary>

code: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locationsDetails%20%3E%20(items)%20%3E%20(property)%20code">Link to this property</a>

name: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locationsDetails%20%3E%20(items)%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20locationsDetails">Link to this property</a>

origins: List\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20origins">Link to this property</a>

<details>

<summary>

origins\_details: List\[AnnotationOriginsDetail]

</summary>

name: Optional\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20originsDetails%20%3E%20(items)%20%3E%20(property)%20name">Link to this property</a>

origin: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20originsDetails%20%3E%20(items)%20%3E%20(property)%20origin">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20originsDetails">Link to this property</a>

<details>

<summary>

outage: Optional\[AnnotationOutage]

</summary>

outage\_cause: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20outage%20%3E%20(property)%20outageCause">Link to this property</a>

outage\_type: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20outage%20%3E%20(property)%20outageType">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20outage">Link to this property</a>

scope: Optional\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20scope">Link to this property</a>

start\_date: datetime

formatdate-time

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20startDate">Link to this property</a>

tags: List\[str]

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20tags">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_get_response%20%3E%20(schema)%20%3E%20(property)%20annotations">Link to this property</a>

</details>

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

<details>

<summary>

class OutageLocationsResponse: …

</summary>

<details>

<summary>

annotations: List\[Annotation]

</summary>

client\_country\_alpha2: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_locations_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20clientCountryAlpha2">Link to this property</a>

client\_country\_name: str

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_locations_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20clientCountryName">Link to this property</a>

value: str

A numeric string.

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_locations_response%20%3E%20(schema)%20%3E%20(property)%20annotations%20%3E%20(items)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20radar.annotations.outages%20%3E%20(model)%20outage_locations_response%20%3E%20(schema)%20%3E%20(property)%20annotations">Link to this property</a>

</details>

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