---
title: "Retrieve alert details."
method: GET
path: "/api-public/v1/alerts/{uuid}"
tags: ["Alerts"]
---

# Retrieve alert details.

`GET /api-public/v1/alerts/{uuid}`

Retrieve the details of an alert that was sent VictorOps by you.

This API may be called a maximum of 2 times per second.

## Path parameters

- `uuid` string, required

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Response `200`

The alert, if found.

- GetAlertResponse — Alert details. All fields should be considered optional.
  - `messageType` string — The type of alert; INFO, WARNING, ACKNOWLEDGEMENT, CRITICAL, RECOVERY
  - `entityId` string — Identifies the entity (host, service, etc.) this alert was about.
  - `timestamp` number — Timestamp of the alert in seconds since epoch.
  - `stateStartTime` number — The time this entity entered its current state (seconds since epoch).
  - `stateMessage` string — Any additional status information from the alert item.
  - `monitoringTool` string — The name of the monitoring system software (eg. nagios, icinga, sensu, etc.)
  - `entityDisplayName` string — Used within VictorOps to display a human-readable name for the entity.
  - `ackMsg` string — A user entered comment for the acknowledgment.
  - `ackAuthor` string — The user that acknowledged the incident.
  - `raw` string — The full, raw alert details JSON string (i.e. parse the string into a JSON object)

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — User not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/victorops/apis/victorops-api.md) · [All operations](https://skmtc.net/victorops/apis/victorops-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/victorops/victorops-api/revisions/7a7391256058/schema)