Skip to main content
GET
List
🔑 Requires the incidents.view scope.

Authorizations

Authorization
string
header
required

API key from your incident.io dashboard (Settings → API keys)

Query Parameters

page_size
integer<int64>
default:25

Integer number of records to return

Required range: x <= 500
Example:

25

after
string

An incident's ID. This endpoint will return a list of incidents after this ID in relation to the API response order.

Example:

"01FDAG4SAP5TYPT98WGR2N7W91"

sort_by
enum<string>
default:created_at_newest_first

What order to return results in.

Available options:
created_at_newest_first,
created_at_oldest_first
Example:

"created_at_newest_first"

filter_mode
enum<string>

How to combine the filters: 'all' combines them with AND logic (all must match), 'any' combines them with OR logic (any can match). Defaults to 'all'.

Available options:
all,
any
Example:

"all"

status
object

Filter on incident status. The accepted operators are 'one_of', or 'not_in'.

Example:
status_category
object

Filter on the category of the incidents status. The accepted operators are 'one_of', or 'not_in'.

Example:
created_at
object

Filter on incident created at timestamp. The accepted operators are 'gte', 'lte' and 'date_range'.

Example:
updated_at
object

Filter on incident updated at timestamp. The accepted operators are 'gte', 'lte' and 'date_range'.

Example:
severity
object

Filter on incident severity. The accepted operators are 'one_of', 'not_in', 'gte', 'lte'.

Example:
incident_type
object

Filter on incident type. The accepted operators are 'one_of, or 'not_in'.

Example:
incident_role
object

Filter on an incident role. Role ID should be sent, along with backlink attribute ID (if needed) followed by the operator and values. The accepted operators are 'one_of', 'is_blank'.

Example:
custom_field
object

Filter on an incident custom field. Custom field ID should be sent, followed by the operator and values. Accepted operator will depend on the custom field type.

Example:
mode
object

Filter on incident mode. The accepted operator is 'one_of'. If this is not provided, this value defaults to {"one_of": ["standard", "retrospective"] }, meaning that test and tutorial incidents are not included.

Example:

Response

200 - application/json

OK response.

incidents
object[]
required
Example:
pagination_meta
object
Example: