Get an alert

Show detailed information about an alert. Accepts an alert id.

An incident represents a problem or an issue that needs to be addressed and resolved.

When a service sends an event to PagerDuty, an alert and corresponding incident is triggered in PagerDuty.

For more information see the API Concepts Document

Scoped OAuth requires: incidents.read

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

alert_id*string

The id of the alert to retrieve.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Response Body

`application/json`

curl -X GET "https://example.com/incidents/{id}/alerts/{alert_id}" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json"

{  "alert": {    "id": "PT4KHLK",    "type": "alert",    "summary": "The server is on fire.",    "self": "https://api.pagerduty.com/incident/PT4KHLX/alerts/PT4KHLK",    "html_url": "https://subdomain.pagerduty.com/alerts/PT4KHLK",    "created_at": "2015-10-06T21:30:42Z",    "status": "resolved",    "alert_key": "baf7cf21b1da41b4b0221008339ff357",    "service": {      "id": "PIJ90N7",      "type": "service_reference",      "summary": "My Mail Service",      "self": "https://api.pagerduty.com/services/PIJ90N7",      "html_url": "https://subdomain.pagerduty.com/service-directory/PIJ90N7"    },    "incident": {      "id": "PT4KHLX",      "type": "incident_reference",      "summary": "[#1234] The server is on fire.",      "self": "https://api.pagerduty.com/incidents/PT4KHLX",      "html_url": "https://subdomain.pagerduty.com/incidents/PT4KHLX"    },    "suppressed": false,    "severity": "critical",    "integration": {      "id": "PQ12345",      "type": "generic_email_inbound_integration_reference",      "summary": "Email Integration",      "self": "https://api.pagerduty.com/services/PIJ90N7/integrations/PQ12345",      "html_url": "https://subdomain.pagerduty.com/services/PIJ90N7/integrations/PQ12345"    }  }}

Get an alert

Authorization

Path Parameters

Header Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`