## Get latest annotations

`client.radar.annotations.list(AnnotationListParamsquery?, RequestOptionsoptions?): AnnotationListResponse`

**get** `/radar/annotations`

Retrieves the latest annotations.

### Parameters

- `query: AnnotationListParams`

  - `asn?: number`

    Filters results by Autonomous System. Specify a single Autonomous System Number (ASN) as integer.

  - `dataSource?: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

    Filters results by data source.

    - `"ALL"`

    - `"AI_BOTS"`

    - `"AI_GATEWAY"`

    - `"BGP"`

    - `"BOTS"`

    - `"CONNECTION_ANOMALY"`

    - `"CT"`

    - `"DNS"`

    - `"DNS_MAGNITUDE"`

    - `"DNS_AS112"`

    - `"DOS"`

    - `"EMAIL_ROUTING"`

    - `"EMAIL_SECURITY"`

    - `"FW"`

    - `"FW_PG"`

    - `"HTTP"`

    - `"HTTP_CONTROL"`

    - `"HTTP_CRAWLER_REFERER"`

    - `"HTTP_ORIGINS"`

    - `"IQI"`

    - `"LEAKED_CREDENTIALS"`

    - `"NET"`

    - `"ROBOTS_TXT"`

    - `"SPEED"`

    - `"WORKERS_AI"`

  - `dateEnd?: string`

    End of the date range (inclusive).

  - `dateRange?: string`

    Filters results by date range.

  - `dateStart?: string`

    Start of the date range (inclusive).

  - `eventType?: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

    Filters results by event type.

    - `"EVENT"`

    - `"GENERAL"`

    - `"OUTAGE"`

    - `"PARTIAL_PROJECTION"`

    - `"PIPELINE"`

    - `"TRAFFIC_ANOMALY"`

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `limit?: number`

    Limits the number of objects returned in the response.

  - `location?: string`

    Filters results by location. Specify an alpha-2 location code.

  - `offset?: number`

    Skips the specified number of objects before fetching the results.

  - `origin?: string`

    Filters results by origin.

### Returns

- `AnnotationListResponse`

  - `annotations: Array<Annotation>`

    - `id: string`

    - `asns: Array<number>`

    - `asnsDetails: Array<ASNsDetail>`

      - `asn: string`

      - `name: string`

      - `locations?: Locations`

        - `code: string`

        - `name: string`

    - `dataSource: string`

    - `eventType: string`

    - `locations: Array<string>`

    - `locationsDetails: Array<LocationsDetail>`

      - `code: string`

      - `name: string`

    - `origins: Array<string>`

    - `originsDetails: Array<OriginsDetail>`

      - `name: string`

      - `origin: string`

    - `outage: Outage`

      - `outageCause: string`

      - `outageType: string`

    - `startDate: string`

    - `description?: string`

    - `endDate?: string`

    - `linkedUrl?: string`

    - `scope?: string`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const annotations = await client.radar.annotations.list();

console.log(annotations.annotations);
```

#### Response

```json
{
  "result": {
    "annotations": [
      {
        "id": "550",
        "asns": [
          189
        ],
        "asnsDetails": [
          {
            "asn": "189",
            "name": "LUMEN-LEGACY-L3-PARTITION",
            "locations": {
              "code": "US",
              "name": "United States"
            }
          }
        ],
        "dataSource": "ALL",
        "eventType": "OUTAGE",
        "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"
        },
        "startDate": "2022-09-06T10:00:28Z",
        "description": "example",
        "endDate": "2022-09-08T10:00:28Z",
        "linkedUrl": "http://example.com",
        "scope": "Colima, Michoacán, México"
      }
    ]
  },
  "success": true
}
```