Skip to main content
GET
/
v2
/
alerts
/
{identifier}
curl -X GET "https://api.warrn.io/v2/alerts/cpu-high-web-03?identifierType=alias" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..."

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "tinyId": "A1B2C3D4",
    "alias": "cpu-high-web-03",
    "message": "CPU usage above 95% on web-server-03",
    "status": "open",
    "acknowledged": false,
    "isSeen": false,
    "tags": ["cpu", "infrastructure", "production", "opsgenie-migrated"],
    "snoozed": false,
    "count": 1,
    "lastOccurredAt": "2026-05-05T14:30:00+05:30",
    "createdAt": "2026-05-05T14:30:00+05:30",
    "updatedAt": "2026-05-05T14:30:00+05:30",
    "source": "Datadog Monitor #4521",
    "priority": "P1",
    "teams": [
      {"id": "f1e2d3c4-b5a6-7890-1234-567890abcdef", "name": "Infrastructure"}
    ],
    "responders": [
      {"type": "team", "id": "f1e2d3c4-b5a6-7890-1234-567890abcdef", "name": "Infrastructure"}
    ],
    "entity": "web-frontend",
    "description": "CPU has been above 95% for 5 minutes.",
    "details": {
      "host": "web-server-03",
      "cpu_percent": "97.3",
      "region": "us-east-1"
    },
    "report": null
  },
  "requestId": "f7a8b9c0-d1e2-3456-7890-abcdef123456"
}

Documentation Index

Fetch the complete documentation index at: https://docs.warrn.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve alert details in OpsGenie response format. Supports lookup by alias, ID, or tiny ID.

​
Authentication

​
Authorization
string
required
Bearer token. Format: Bearer warrn_xxx. Requires read permission.

​
Path Parameters

​
identifier
string
required
The alert identifier.

​
Query Parameters

​
identifierType
string
default:"id"
How to interpret the identifier. One of: id, alias, tiny.

​
Response

Returns the alert in OpsGenie format with mapped fields.
​
data.id
string
Warrn alert UUID.
​
data.tinyId
string
First 8 characters of the UUID (uppercase).
​
data.alias
string
Alert alias.
​
data.message
string
Alert name (mapped from Warrn name field).
​
data.status
string
One of: open, acknowledged, closed.
​
data.priority
string
OpsGenie priority (P1-P5), mapped from Warrn severity.
​
data.teams
object[]
Array of team objects with id and name.
​
data.tags
string[]
Alert tags.
​
data.details
object
Alert metadata (excluding internal fields).
​
data.description
string
Alert description.
​
data.createdAt
string
ISO 8601 timestamp.

​
Example

curl -X GET "https://api.warrn.io/v2/alerts/cpu-high-web-03?identifierType=alias" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..."

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "tinyId": "A1B2C3D4",
    "alias": "cpu-high-web-03",
    "message": "CPU usage above 95% on web-server-03",
    "status": "open",
    "acknowledged": false,
    "isSeen": false,
    "tags": ["cpu", "infrastructure", "production", "opsgenie-migrated"],
    "snoozed": false,
    "count": 1,
    "lastOccurredAt": "2026-05-05T14:30:00+05:30",
    "createdAt": "2026-05-05T14:30:00+05:30",
    "updatedAt": "2026-05-05T14:30:00+05:30",
    "source": "Datadog Monitor #4521",
    "priority": "P1",
    "teams": [
      {"id": "f1e2d3c4-b5a6-7890-1234-567890abcdef", "name": "Infrastructure"}
    ],
    "responders": [
      {"type": "team", "id": "f1e2d3c4-b5a6-7890-1234-567890abcdef", "name": "Infrastructure"}
    ],
    "entity": "web-frontend",
    "description": "CPU has been above 95% for 5 minutes.",
    "details": {
      "host": "web-server-03",
      "cpu_percent": "97.3",
      "region": "us-east-1"
    },
    "report": null
  },
  "requestId": "f7a8b9c0-d1e2-3456-7890-abcdef123456"
}