Get a list of incidents
get
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/incidents
Returns a list of incidents based on the filters specified. By default, it returns the first set of all open incidents with the most recently created incidents listed first.
Request
Query Parameters
-
ageInHoursLessThanOrEqualTo: integer(int32)
Get incidents which are newer than the number of days specifiedDefault Value:
744
Example:24
-
includeMemberTargets: boolean
Include matching incidents on members of the given targetDefault Value:
true
-
limit: integer(int32)
Limits number of items returned in current call. Use the self/previous/next links from the response to fetch additional items.Default Value:
50
-
page: string
Identifies the set of items to be fetched; "href" element from "links" list of the response provides encoded value for this parameter. "href" element value should be used "as is" for fetching respective set of items.Default Value:
Base64 encode value of 0 i.e MA==
-
severity: array[]
Filter by specified severities
-
sort: string
Sort results by attributes such as id, displayId, timeCreated, timeUpdated, status and ownerExample:
displayId:ASC,timeUpdated:DESC
-
targetName: string
Filter by specific target name.
-
targetTypeName: string
Filter by specific target type.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation - Fetch incident list
Root Schema : IncidentCollection
List of incident summary
Match All
Show Source
-
object
ListRspns
Generic list response wrapper
-
object
IncidentCollection-allOf[1]
Nested Schema : ListRspns
Type:
object
Generic list response wrapper
Show Source
-
count(required): integer
(int32)
Number of rows returnedExample:
1
-
links: object
links
Read Only:
true
URL links to paginated resource(s).
Nested Schema : IncidentCollection-allOf[1]
Type:
Show Source
object
-
items(required): array
items
List of the incident summary
Nested Schema : links
Type:
object
Read Only:
true
URL links to paginated resource(s).
Show Source
-
next: object
Link
Represents a link(could be self, previous or next)
-
previous: object
Link
Represents a link(could be self, previous or next)
-
self(required): object
Link
Represents a link(could be self, previous or next)
Example:
{
"self":{
"href":"/em/api/incidents?page=MQ%3D%3D&limit=50"
},
"next":{
"href":"/em/api/incidents?page=Mg%3D%3D&limit=50"
},
"previous":{
"href":"/em/api/incidents?page=MA%3D%3D&limit=50"
}
}
Nested Schema : Link
Type:
object
Represents a link(could be self, previous or next)
Show Source
-
href: string
URL for LinkExample:
/em/api/<resources>?page=b2Zmc2V0OjA&limit=0
Nested Schema : items
Type:
array
List of the incident summary
Show Source
-
Array of:
object IncidentSummary
Summary of an incident
Nested Schema : IncidentSummary
Type:
object
Summary of an incident
Show Source
-
ageInHours: integer
(int64)
Read Only:
true
Incident age in hoursExample:855
-
canBeManuallyClosed: boolean
Default Value:
false
Can the incident be cleared by user?Example:true
-
displayId(required): integer
(int64)
Read Only:
true
Display ID of the incidentExample:35
-
escalationLevel: object
EscalationLevel
Details of an escalation level
-
id(required): string
(raw)
Read Only:
true
ID of the incidentExample:C4E214A1172A2F19E053860E4B645AC7
-
isDiagnosticIncident: boolean
Default Value:
false
Is it a Automatic Diagnostic Repository (ADR) incident?Example:false
-
isEscalated: boolean
Is the incident escalated?Example:
true
-
isOpen(required): boolean
Is the incident open?Example:
true
-
links: object
links
Read Only:
true
URL links inside details of resource. -
message(required): string
Message of the incidentExample:
CPU Utilization is 10.821%, crossed warning (5) or critical (10) threshold.
-
nonTargetEntities: array
nonTargetEntities
Minimum Number of Items:
0
Unique Items Required:true
Entities (jobs, etc.) other than targets which are affected by this incident -
owner: string
Current owner of the incidentExample:
SYSMAN
-
priority: object
Priority
Details of an priority
-
severity(required): string
Read Only:
true
Allowed Values:[ "FATAL", "CRITICAL", "WARNING", "MINOR_WARNING", "CLEAR" ]
Supported list of the severitiesExample:CRITICAL
-
status(required): string
Current status of the incidentExample:
new
-
suppressionStatus: object
SuppressionStatus
Details of an suppression status
-
targets: array
targets
Minimum Number of Items:
0
Unique Items Required:true
Targets affected by this incident -
ticket: object
TicketSummary
Read Only:
true
Details of the ticket -
timeCreated(required): string
(date-time)
Read Only:
true
Time when incident is createdExample:2021-06-16T12:17:56.000Z
-
timeUpdated(required): string
(date-time)
Read Only:
true
Time when incident is updatedExample:2021-07-22T06:25:42.000Z
Nested Schema : EscalationLevel
Type:
object
Details of an escalation level
Show Source
-
displayName: string
Display name of the escalation levelExample:
None
-
name(required): string
Read Only:
true
Allowed Values:[ "NONE", "L1", "L2", "L3", "L4", "L5" ]
Supported list of the escalataion levelsExample:NONE
Nested Schema : links
Type:
object
Read Only:
true
URL links inside details of resource.
Show Source
-
self(required): object
Link
Represents a link(could be self, previous or next)
Example:
{
"self":{
"href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7"
}
}
Nested Schema : nonTargetEntities
Type:
array
Minimum Number of Items:
0
Unique Items Required:
true
Entities (jobs, etc.) other than targets which are affected by this incident
Show Source
-
Array of:
object SourceEntity
Details of an source entity
Nested Schema : Priority
Type:
object
Details of an priority
Show Source
-
displayName: string
Read Only:
true
Display label for the priorityExample:None
-
name(required): string
Internal name for the priorityExample:
PRIORITY_NONE
Nested Schema : SuppressionStatus
Type:
object
Details of an suppression status
Show Source
-
isSuppressed(required): boolean
Default Value:
false
Is the supression enabled? -
suppressUntil: string
Allowed Values:
[ "MANUALLY_UNSUPPRESSED", "INCIDENT_CLOSES", "INCIDENT_SEVERITY_CHANGES", "AFTER_A_DAY", "AFTER_A_WEEK", "AFTER_DATE" ]
Supression type -
timeToEndSuppression: string
(date-time)
Supression end time
Nested Schema : targets
Type:
array
Minimum Number of Items:
0
Unique Items Required:
true
Targets affected by this incident
Show Source
-
Array of:
object schema
Target details
Nested Schema : TicketSummary
Type:
object
Read Only:
true
Details of the ticket
Show Source
-
id: string
Read Only:
true
ID of the ticketExample:51d62b6cd1384ba89aeddfa647ea1380
-
status: string
Status of the ticketExample:
Triggered
-
type: string
Type of the ticketExample:
TICKET
-
url: string
URL of the ticketExample:
https://api.pagerduty.com/incidents?incident_key=F746283FHDKC
Nested Schema : SourceEntity
Type:
object
Details of an source entity
Show Source
-
id(required): string
(raw)
ID of the entityExample:
317C6AD6C69832D0ADDA279BEB7B7F32
-
name(required): string
Name of the entityExample:
bkupjob-123456
-
subTypeDisplayName: string
Display name for sub type for an entity typeExample:
Database backup job
-
subTypeName: string
Sub type for an entity typeExample:
DBBackupJob
-
typeDisplayName: string
Display name for the entity typeExample:
Job
-
typeName(required): string
Type of the entityExample:
JOB
Nested Schema : schema
Type:
object
Target details
Show Source
-
targetName: string
Name of the targetExample:
sales_db1
-
targetType: string
Type of the targetExample:
oracle_database
400 Response
Bad Request
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
401 Response
Unauthorized
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
404 Response
Not Found
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
500 Response
Internal Server Error
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
503 Response
Service Unavailable
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string