--- title: Get latest annotations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Radar](https://developers.cloudflare.com/api/resources/radar) [Annotations](https://developers.cloudflare.com/api/resources/radar/subresources/annotations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get latest annotations GET/radar/annotations Retrieves the latest annotations. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `User Details Write``User Details Read` ##### Q uery ParametersExpand Collapse asn: optional number Filters results by Autonomous System. Specify a single Autonomous System Number (ASN) as integer. [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20asn%20%3E%20(schema)>) bot: optional string Filters results by bot. maxLength100 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20bot%20%3E%20(schema)>) ca: optional string Filters results by certificate authority. maxLength100 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20ca%20%3E%20(schema)>)

dataSource: optional "ALL"or "AI\_BOTS"or "AI\_GATEWAY"or 22 more Filters results by data source.

[Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20dataSource%20%3E%20(schema)>) dateEnd: optional string End of the date range (inclusive). Alternative to `dateRange`; provide together with `dateStart`. formatdate-time [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20dateEnd%20%3E%20(schema)>) dateRange: optional string Filters results by a relative date range ending at the current time. Use `d` for days (up to `364d`) or `w` for weeks (up to `52w`), e.g. `7d`. Append `control` to request the equivalent previous period for comparison: the comparison window is shifted back by the current window’s length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. `3dcontrol` covers days -10 to -7, `7dcontrol` covers days -14 to -7, `28dcontrol` covers days -56 to -28, and `10dcontrol` covers days -24 to -14). Mutually exclusive with `dateStart`/`dateEnd`. [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20dateRange%20%3E%20(schema)>) dateStart: optional string Start of the date range (inclusive). Alternative to `dateRange`; provide together with `dateEnd`. formatdate-time [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20dateStart%20%3E%20(schema)>)

eventType: optional "EVENT"or "GENERAL"or "OUTAGE"or 3 more Filters results by event type. EVENT is a legacy alias for GENERAL.

One of the following: "EVENT" Link to this property "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](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20eventType%20%3E%20(schema)>)

format: optional "JSON"or "CSV" Format in which results will be returned.

One of the following: "JSON" Link to this property "CSV" Link to this property

[Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20format%20%3E%20(schema)>) geoId: optional string Filters results by geolocation. Refer to [GeoNames](https://download.geonames.org/export/dump/readme.txt). maxLength100 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20geoId%20%3E%20(schema)>) limit: optional number Limits the number of objects returned in the response. exclusiveMinimum minimum0 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20limit%20%3E%20(schema)>) location: optional string Filters results by location. Specify an alpha-2 location code. maxLength2 minLength2 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20location%20%3E%20(schema)>) log: optional string Filters results by certificate log. maxLength100 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20log%20%3E%20(schema)>) offset: optional number Skips the specified number of objects before fetching the results. minimum0 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20offset%20%3E%20(schema)>) origin: optional string Filters results by origin. maxLength100 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20origin%20%3E%20(schema)>)

outageCause: optional "BLOCKING"or "CABLE\_CUT"or "CYBERATTACK"or 14 more Filters results by outage cause.

[Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20outageCause%20%3E%20(schema)>)

outageType: optional "NATIONWIDE"or "REGIONAL"or "NETWORK"or "PLATFORM" Filters results by outage type.

One of the following: "NATIONWIDE" Link to this property "REGIONAL" Link to this property "NETWORK" Link to this property "PLATFORM" Link to this property

[Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20outageType%20%3E%20(schema)>) query: optional string Filters results by a free-text match on the annotation description, id, or linked entities (location, ASN, origin). maxLength100 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20query%20%3E%20(schema)>)

tags: optional array of "ADM1"or "ADM2"or "API\_TRAFFIC"or 93 more Filters results by annotation tag. Matches annotations carrying at least one of the given tags.

[Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20tags%20%3E%20(schema)>) tld: optional string Filters results by top-level domain. maxLength63 minLength2 [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20tld%20%3E%20(schema)>) ##### ReturnsExpand Collapse

result: object {annotations }

annotations: array of object {id, asns, asnsDetails, 15 more }

id: string Link to this property asns: array of number Link to this property

asnsDetails: array of object {asn, location, name }

asn: string Link to this property

location: object {code, name }

code: string Link to this property name: string Link to this property

Link to this property name: string Link to this property

Link to this property dataSource: string Link to this property description: string Link to this property endDate: string Link to this property

entities: array of object {entityName, entityType, entityValue }

entityName: string Link to this property entityType: string Link to this property entityValue: string Link to this property

Link to this property eventType: string Link to this property geoIds: array of string Link to this property linkedUrl: string Link to this property locations: array of string Link to this property

locationsDetails: array of object {code, name }

code: string Link to this property name: string Link to this property

Link to this property origins: array of string Link to this property

originsDetails: array of object {name, origin }

name: string Link to this property origin: string Link to this property

Link to this property

outage: object {outageCause, outageType }

outageCause: string Link to this property outageType: string Link to this property

Link to this property scope: string Link to this property startDate: string Link to this property tags: array of string Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: boolean [Link to this property](<#(resource)%20radar.annotations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### Get latest annotations HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/radar/annotations \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "result": { "annotations": [ { "id": "550", "asns": [ 189 ], "asnsDetails": [ { "asn": "189", "location": { "code": "US", "name": "United States" }, "name": "LUMEN-LEGACY-L3-PARTITION" } ], "dataSource": "ALL", "description": "example", "endDate": "2022-09-08T10:00:28Z", "entities": [ { "entityName": "GPTBot", "entityType": "BOT", "entityValue": "gptbot" } ], "eventType": "OUTAGE", "geoIds": [ "2267057" ], "linkedUrl": "http://example.com", "locations": [ "US" ], "locationsDetails": [ { "code": "US", "name": "United States" } ], "origins": [ "amazon-us-east-1" ], "originsDetails": [ { "name": "us-east-1 Amazon Web Services", "origin": "amazon-us-east-1" } ], "outage": { "outageCause": "CABLE_CUT", "outageType": "NATIONWIDE" }, "scope": "Colima, Michoacán, México", "startDate": "2022-09-06T10:00:28Z", "tags": [ "string" ] } ] }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "annotations": [ { "id": "550", "asns": [ 189 ], "asnsDetails": [ { "asn": "189", "location": { "code": "US", "name": "United States" }, "name": "LUMEN-LEGACY-L3-PARTITION" } ], "dataSource": "ALL", "description": "example", "endDate": "2022-09-08T10:00:28Z", "entities": [ { "entityName": "GPTBot", "entityType": "BOT", "entityValue": "gptbot" } ], "eventType": "OUTAGE", "geoIds": [ "2267057" ], "linkedUrl": "http://example.com", "locations": [ "US" ], "locationsDetails": [ { "code": "US", "name": "United States" } ], "origins": [ "amazon-us-east-1" ], "originsDetails": [ { "name": "us-east-1 Amazon Web Services", "origin": "amazon-us-east-1" } ], "outage": { "outageCause": "CABLE_CUT", "outageType": "NATIONWIDE" }, "scope": "Colima, Michoacán, México", "startDate": "2022-09-06T10:00:28Z", "tags": [ "string" ] } ] }, "success": true } ```