---
title: "Get a list of events"
method: GET
path: "/api/v2/events"
tags: ["Events"]
---

# Get a list of events

`GET /api/v2/events`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/events`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `events_read`

List endpoint returns events that match an events search query.
[Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination).

Use this endpoint to see your latest events.

## Query parameters

- `filter[query]` string
- `filter[from]` string
- `filter[to]` string
- `sort` 'timestamp' | '-timestamp': The sort parameters when querying events.
- `page[cursor]` string
- `page[limit]` integer

## Response `200`

OK

- EventsListResponse: The response object with all events matching the request and pagination information.
  - `data` EventResponse[]: An array of events matching the request.
    - `attributes` EventResponseAttributes: The object description of an event response attribute.
      - `attributes` EventAttributes: Object description of attributes from your event.
        - `aggregation_key` string: Aggregation key of the event.
        - `date_happened` integer: POSIX timestamp of the event. Must be sent as an integer (no quotation marks). Limited to events no older than 18 hours.
        - `device_name` string: A device name.
        - `duration` integer: The duration between the triggering of the event and its recovery in nanoseconds.
        - `event_object` string: The event title.
        - `evt` Event: The metadata associated with a request.
          - `id` string: Event ID.
          - `name` string: The event name.
          - `source_id` integer: Event source ID.
          - `type` string: Event type.
        - `hostname` string: Host name to associate with the event. Any tags associated with the host are also applied to this event.
        - `monitor` MonitorType, nullable: Attributes from the monitor that triggered the event.
          - `created_at` integer: The POSIX timestamp of the monitor's creation in nanoseconds.
          - `group_status` integer: Monitor group status used when there is no `result_groups`.
          - `groups` string[]: Groups to which the monitor belongs.
          - `id` integer: The monitor ID.
          - `message` string: The monitor message.
          - `modified` integer: The monitor's last-modified timestamp.
          - `name` string: The monitor name.
          - `query` string: The query that triggers the alert.
          - `tags` string[]: A list of tags attached to the monitor.
          - `templated_name` string: The templated name of the monitor before resolving any template variables.
          - `type` string: The monitor type.
        - `monitor_groups` string[], nullable: List of groups referred to in the event.
        - `monitor_id` integer, nullable: ID of the monitor that triggered the event. When an event isn't related to a monitor, this field is empty.
        - `priority` 'normal' | 'low', nullable: The priority of the event's monitor. For example, `normal` or `low`.
        - `related_event_id` integer: Related event ID.
        - `service` string: Service that triggered the event.
        - `source_type_name` string: The type of event being posted. For example, `nagios`, `hudson`, `jenkins`, `my_apps`, `chef`, `puppet`, `git` or `bitbucket`. The list of standard source attribute values is [available here](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
        - `sourcecategory` string: Identifier for the source of the event, such as a monitor alert, an externally-submitted event, or an integration.
        - `status` 'failure' | 'error' | 'warning' | 'info' | 'success' | 'user_update' | 'recommendation' | 'snapshot': If an alert event is enabled, its status is one of the following: `failure`, `error`, `warning`, `info`, `success`, `user_update`, `recommendation`, or `snapshot`.
        - `tags` string[]: A list of tags to apply to the event.
        - `timestamp` integer: POSIX timestamp of your event in milliseconds.
        - `title` string: The event title.
      - `message` string: The message of the event.
      - `tags` string[]: An array of tags associated with the event.
      - `timestamp` string, date-time: The timestamp of the event.
    - `id` string: the unique ID of the event.
    - `type` 'event': Type of the event.
  - `links` EventsListResponseLinks: Links attributes.
    - `next` string: Link for the next set of results. Note that the request can also be made using the POST endpoint.
  - `meta` EventsResponseMetadata: The metadata associated with a request.
    - `elapsed` integer: The time elapsed in milliseconds.
    - `page` EventsResponseMetadataPage: Pagination attributes.
      - `after` string: The cursor to use to get the next results, if any. To make the next request, use the same parameters with the addition of the `page[cursor]`.
    - `request_id` string: The identifier of the request.
    - `status` string: The request status.
    - `warnings` EventsWarning[]: A list of warnings (non-fatal errors) encountered. Partial results might be returned if warnings are present in the response.
      - `code` string: A unique code for this type of warning.
      - `detail` string: A detailed explanation of this specific warning.
      - `title` string: A short human-readable summary of the warning.

## Other responses

- `400`: Bad Request
- `403`: Not Authorized
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)