---
title: Annotations
---

[Skip to content](#%5Ftop) 

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

[Radar](https://developers.cloudflare.com/api/typescript/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/typescript/resources/radar/subresources/annotations/methods/list)

client.radar.annotations.list(AnnotationListParams { asn, bot, ca, 17 more } query?, RequestOptionsoptions?): [AnnotationListResponse](https://developers.cloudflare.com/api/typescript/resources/radar#%28resource%29%20radar.annotations%20%3E%20%28model%29%20annotation%5Flist%5Fresponse%20%3E%20%28schema%29) { annotations } 

GET/radar/annotations

##### ModelsExpand Collapse 

AnnotationListResponse { annotations } 

annotations: Array<Annotation\>

id: string

asns: Array<number\>

asnsDetails: Array<ASNsDetail\>

asn: string

location: Location | null

code: string

name: string

name: string | null

dataSource: string

description: string | null

endDate: string | null

entities: Array<Entity\>

entityName: string | null

entityType: string

entityValue: string

eventType: string

geoIds: Array<string\>

linkedUrl: string | null

locations: Array<string\>

locationsDetails: Array<LocationsDetail | null\>

code: string

name: string

origins: Array<string\>

originsDetails: Array<OriginsDetail\>

name: string | null

origin: string

outage: Outage | null

outageCause: string

outageType: string

scope: string | null

startDate: string

tags: Array<string\>

#### AnnotationsOutages

##### [Get latest Internet outages and anomalies](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/annotations/subresources/outages/methods/get)

client.radar.annotations.outages.get(OutageGetParams { asn, bot, ca, 16 more } query?, RequestOptionsoptions?): [OutageGetResponse](https://developers.cloudflare.com/api/typescript/resources/radar#%28resource%29%20radar.annotations.outages%20%3E%20%28model%29%20outage%5Fget%5Fresponse%20%3E%20%28schema%29) { annotations } 

GET/radar/annotations/outages

##### [Get the number of outages by location](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/annotations/subresources/outages/methods/locations)

client.radar.annotations.outages.locations(OutageLocationsParams { dateEnd, dateRange, dateStart, 2 more } query?, RequestOptionsoptions?): [OutageLocationsResponse](https://developers.cloudflare.com/api/typescript/resources/radar#%28resource%29%20radar.annotations.outages%20%3E%20%28model%29%20outage%5Flocations%5Fresponse%20%3E%20%28schema%29) { annotations } 

GET/radar/annotations/outages/locations

##### ModelsExpand Collapse 

OutageGetResponse { annotations } 

annotations: Array<Annotation\>

id: string

asns: Array<number\>

asnsDetails: Array<ASNsDetail\>

asn: string

location: Location | null

code: string

name: string

name: string | null

dataSource: string

description: string | null

endDate: string | null

formatdate-time

entities: Array<Entity\>

entityName: string | null

entityType: string

entityValue: string

eventType: string

geoIds: Array<string\>

linkedUrl: string | null

locations: Array<string\>

locationsDetails: Array<LocationsDetail | null\>

code: string

name: string

origins: Array<string\>

originsDetails: Array<OriginsDetail\>

name: string | null

origin: string

outage: Outage | null

outageCause: string

outageType: string

scope: string | null

startDate: string

formatdate-time

tags: Array<string\>

OutageLocationsResponse { annotations } 

annotations: Array<Annotation\>

clientCountryAlpha2: string

clientCountryName: string

value: string

A numeric string.