---
title: "Get an event"
method: GET
path: "/api/v2/events/{event_id}"
tags: ["Events"]
---

# Get an event

`GET /api/v2/events/{event_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/events/{event_id}`
- 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`

Get the details of an event by `event_id`.

## Path parameters

- `event_id` string, required

## Response `200`

OK

- V2EventResponse: Get an event response.
  - `data` V2Event: An event object.
    - `attributes` V2EventAttributes: Event attributes.
      - `attributes` union: JSON object for category-specific attributes.
        - ChangeEventAttributes: Change event attributes.
          - `aggregation_key` string: Aggregation key of the event.
          - `author` ChangeEventAttributesAuthor: The entity that made the change.
            - `name` string: The name of the user or system that made the change.
            - `type` 'user' | 'system' | 'api' | 'automation': The type of the author.
          - `change_metadata` object: JSON object of change metadata.
          - `changed_resource` ChangeEventAttributesChangedResource: A uniquely identified resource.
            - `name` string: The name of the changed resource.
            - `type` 'feature_flag' | 'configuration': The type of the changed resource.
          - `evt` EventSystemAttributes: JSON object of event system attributes.
            - `category` 'change' | 'alert': Event category identifying the type of event.
            - `id` string: Event identifier. This field is deprecated and will be removed in a future version. Use the `uid` field instead.
            - `integration_id` 'custom-events': Integration ID sourced from integration manifests.
            - `source_id` integer: The source type ID of the event.
            - `uid` string: A unique identifier for the event. You can use this identifier to query or reference the event.
          - `impacted_resources` ChangeEventAttributesImpactedResourcesItem[]: A list of resources impacted by this change.
            - `name` string: The name of the impacted resource.
            - `type` 'service': The type of the impacted resource.
          - `new_value` object: The new state of the changed resource.
          - `prev_value` object: The previous state of the changed resource.
          - `service` string: Service that triggered the event.
          - `timestamp` integer: POSIX timestamp of the event.
          - `title` string: The title of the event.
        - AlertEventAttributes: Alert event attributes.
          - `aggregation_key` string: Aggregation key of the event.
          - `custom` object: JSON object of custom attributes.
          - `evt` EventSystemAttributes: JSON object of event system attributes.
            - `category` 'change' | 'alert': Event category identifying the type of event.
            - `id` string: Event identifier. This field is deprecated and will be removed in a future version. Use the `uid` field instead.
            - `integration_id` 'custom-events': Integration ID sourced from integration manifests.
            - `source_id` integer: The source type ID of the event.
            - `uid` string: A unique identifier for the event. You can use this identifier to query or reference the event.
          - `links` AlertEventAttributesLinksItem[]: The links related to the event.
            - `category` 'runbook' | 'documentation' | 'dashboard': The category of the link.
            - `title` string: The display text of the link.
            - `url` string: The URL of the link.
          - `priority` '1' | '2' | '3' | '4' | '5': The priority of the alert.
          - `service` string: Service that triggered the event.
          - `status` 'warn' | 'error' | 'ok': The status of the alert.
          - `timestamp` integer: POSIX timestamp of the event.
          - `title` string: The title of the event.
      - `message` string: Free-form text associated with the event.
      - `tags` string[]: A list of tags associated with the event.
      - `timestamp` string: Timestamp when the event occurred.
    - `id` string: The event's ID.
    - `type` string: Entity type.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `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)