Read Incident

Access information on an incident in your PagerDuty instance.

Unless otherwise indicated, field type is text.


Read By

  • Incident Key: The unique key that identifies the incident to which a PagerDuty trigger event was applied. An incident key is assigned to an incident to help prevent duplication.



  • Name: A short description of the incident.

  • Incident ID: The identifier that you can assign to an incident.

  • Incident Number(number): The numeric identifier automatically assigned to the incident in your PagerDuty instance.

  • Created At: The date and time when the incident was created.

  • Status:The state of the incident: Triggered, Acknowledged, or Resolved.

  • Pending Actions(list of objects):

    • Type: Options that determine how incidents are dealt with once they are triggered: unacknowledge, escalate, resolve, or urgency_change.

    • At: The number of minutes after which one of the four options on triggered incidents takes effect.

  • Urgency: This feature determines how a team is notified based on the criticality of an incident:

    • High: The incident requires immediate attention.

    • Low: The incident does not require prompt action.

  • Type: The type of integration that can be used to trigger an incident. The type can be incident or incident_reference.

  • URL: The URL to view an incident in your PagerDuty instance.


  • Name: The name of a service against which incidents are opened. For example, an application or component.

  • Service ID: The unique identifier of the of a service.

  • Type: The type of integration for the service. The type can be service or service_reference.

  • URL: This URL of an integrated application or component within your PagerDuty instance.

Escalation Policy

  • Escalation Policy ID: The identifier that was automatically assigned to the escalation policy. An escalation policy ensures the right people are notified at the right time when an incident occurs.

  • Type: The type of escalation policy. The type can be escalation_policy or escalation_policy_reference.

  • Summary: The description of the escalation policy, including user and schedule targets.

  • URL: The URL to view an escalation policy within your PagerDuty instance.

Last Status Change

  • Updated At: The date and time of the latest update to an incident.

  • Updated By ID: The identifier of the person who made the latest update to an incident.

  • Type: The method by which an incident was updated; either email or API.

  • Name: The name of the service against which an incident was updated.

  • URL: The URL of the updated incident.

Related topics