Skip to main content
GET
/
v1
/
alerts
/
{id}
Retrieves an alert
curl --request GET \
  --url https://api.rootly.com/v1/alerts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "da119a38-f1ce-4047-a36a-0b0c9c53a08e",
    "type": "alerts",
    "attributes": {
      "short_id": "ALT100011",
      "source": "pagerduty",
      "status": "open",
      "summary": "Test alert 11",
      "description": "Test alert description",
      "labels": [],
      "services": [],
      "service_ids": [],
      "groups": [],
      "group_ids": [],
      "environments": [],
      "environment_ids": [],
      "responders": [],
      "incidents": [],
      "data": {},
      "deduplication_key": null,
      "started_at": "2026-02-02T00:02:14.317-08:00",
      "ended_at": null,
      "external_id": null,
      "external_url": "https://example.com/alert/test",
      "url": "https://test.rootly.com/account/alerts/da119a38-f1ce-4047-a36a-0b0c9c53a08e",
      "noise": "not_noise",
      "group_leader_alert_id": null,
      "is_group_leader_alert": true,
      "notification_target_type": null,
      "notification_target_id": null,
      "alert_urgency": {
        "id": "78d49243-cd9f-4be1-aa55-aec61cf72d3b",
        "color": "#C73C40",
        "created_at": "2026-02-02T00:02:14.308-08:00",
        "deleted_at": null,
        "description": "Id blanditiis molestiae enim.",
        "name": "zqszc",
        "position": 1,
        "team_id": 38,
        "updated_at": "2026-02-02T00:02:14.314-08:00",
        "urgency": "high"
      },
      "alert_urgency_id": "78d49243-cd9f-4be1-aa55-aec61cf72d3b",
      "notified_users": [],
      "created_at": "2026-02-02T00:02:14.318-08:00",
      "updated_at": "2026-02-02T00:02:14.318-08:00"
    },
    "relationships": {
      "events": {
        "data": [
          {
            "id": "67c82f66-1b18-4294-be9b-3ebd59efefec",
            "type": "alert_events"
          }
        ]
      },
      "alert_group": {
        "data": {
          "id": "473b60d6-c40d-426f-8b18-745369492001",
          "type": "alert_groups"
        }
      },
      "group_leader_alert": {
        "data": {
          "id": "da119a38-f1ce-4047-a36a-0b0c9c53a08e",
          "type": "alerts"
        }
      },
      "group_member_alerts": {
        "data": [
          {
            "id": "77b4fa1a-3881-45a9-9c8e-52d8da3a4b7e",
            "type": "alerts"
          },
          {
            "id": "d1cbab0a-2bdf-4fa9-8ba7-0255839c3281",
            "type": "alerts"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "77b4fa1a-3881-45a9-9c8e-52d8da3a4b7e",
      "type": "alerts",
      "attributes": {
        "short_id": "ALT100013",
        "source": "pagerduty",
        "status": "open",
        "summary": "Test alert 13",
        "description": "Test alert description",
        "labels": [],
        "services": [],
        "service_ids": [],
        "groups": [],
        "group_ids": [],
        "environments": [],
        "environment_ids": [],
        "responders": [],
        "incidents": [],
        "data": {},
        "deduplication_key": null,
        "started_at": "2026-02-02T00:02:14.985-08:00",
        "ended_at": null,
        "external_id": null,
        "external_url": "https://example.com/alert/test",
        "url": "https://test.rootly.com/account/alerts/77b4fa1a-3881-45a9-9c8e-52d8da3a4b7e",
        "noise": "not_noise",
        "group_leader_alert_id": "da119a38-f1ce-4047-a36a-0b0c9c53a08e",
        "is_group_leader_alert": false,
        "notification_target_type": null,
        "notification_target_id": null,
        "alert_urgency": {
          "id": "780f2c51-0a7e-4605-b33b-b59c1bf40ca8",
          "color": "#C73C40",
          "created_at": "2026-02-02T00:02:14.978-08:00",
          "deleted_at": null,
          "description": "Nihil perferendis aperiam eos.",
          "name": "jdh7g",
          "position": 1,
          "team_id": 40,
          "updated_at": "2026-02-02T00:02:14.984-08:00",
          "urgency": "high"
        },
        "alert_urgency_id": "780f2c51-0a7e-4605-b33b-b59c1bf40ca8",
        "notified_users": [],
        "created_at": "2026-02-02T00:02:14.986-08:00",
        "updated_at": "2026-02-02T00:02:14.986-08:00"
      },
      "relationships": {
        "events": {
          "data": [
            {
              "id": "f3a35792-6bf4-4a2f-8d12-d838d4faa2e0",
              "type": "alert_events"
            }
          ]
        },
        "group_member_alerts": {
          "data": []
        }
      }
    },
    {
      "id": "d1cbab0a-2bdf-4fa9-8ba7-0255839c3281",
      "type": "alerts",
      "attributes": {
        "short_id": "ALT100012",
        "source": "pagerduty",
        "status": "open",
        "summary": "Test alert 12",
        "description": "Test alert description",
        "labels": [],
        "services": [],
        "service_ids": [],
        "groups": [],
        "group_ids": [],
        "environments": [],
        "environment_ids": [],
        "responders": [],
        "incidents": [],
        "data": {},
        "deduplication_key": null,
        "started_at": "2026-02-02T00:02:14.652-08:00",
        "ended_at": null,
        "external_id": null,
        "external_url": "https://example.com/alert/test",
        "url": "https://test.rootly.com/account/alerts/d1cbab0a-2bdf-4fa9-8ba7-0255839c3281",
        "noise": "not_noise",
        "group_leader_alert_id": "da119a38-f1ce-4047-a36a-0b0c9c53a08e",
        "is_group_leader_alert": false,
        "notification_target_type": null,
        "notification_target_id": null,
        "alert_urgency": {
          "id": "87bcb81f-56ac-49d0-aa0e-e189977a855c",
          "color": "#C73C40",
          "created_at": "2026-02-02T00:02:14.645-08:00",
          "deleted_at": null,
          "description": "Sunt recusandae neque aut.",
          "name": "jrldd",
          "position": 1,
          "team_id": 39,
          "updated_at": "2026-02-02T00:02:14.651-08:00",
          "urgency": "high"
        },
        "alert_urgency_id": "87bcb81f-56ac-49d0-aa0e-e189977a855c",
        "notified_users": [],
        "created_at": "2026-02-02T00:02:14.653-08:00",
        "updated_at": "2026-02-02T00:02:14.653-08:00"
      },
      "relationships": {
        "events": {
          "data": [
            {
              "id": "f3df1361-1d30-44d8-a78b-a3a1738894d1",
              "type": "alert_events"
            }
          ]
        },
        "group_member_alerts": {
          "data": []
        }
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Query Parameters

include
enum<string>

comma separated if needed. eg: environments,services,groups

Available options:
environments,
services,
groups,
responders,
incidents,
events,
alert_urgency,
heartbeat,
live_call_router,
alert_group,
group_leader_alert,
group_member_alerts,
alert_field_values,
alerting_targets,
escalation_policies,
alert_call_recording,
alert_urgency

Response

alert found with group_member_alerts included

data
object
required