---
title: "POST /listIncidentRecords"
method: POST
path: "/listIncidentRecords"
---

# POST /listIncidentRecords

`POST /listIncidentRecords`

Lists all incident records in your account. Use this command to retrieve the Amazon Resource Name (ARN) of the incident record you want to update.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `filters` Filter[] — <p>Filters the list of incident records you want to search through. You can filter on the following keys:</p> <ul> <li> <p> <code>creationTime</code> </p> </li> <li> <p> <code>impact</code> </p> </li> <li> <p> <code>status</code> </p> </li> <li> <p> <code>createdBy</code> </p> </li> </ul> <p>Note the following when when you use Filters:</p> <ul> <li> <p>If you don't specify a Filter, the response includes all incident records.</p> </li> <li> <p>If you specify more than one filter in a single request, the response returns incident records that match all filters.</p> </li> <li> <p>If you specify a filter with more than one value, the response returns incident records that match any of the values provided.</p> </li> </ul>
    - `condition` object, required — The condition accepts before or after a specified time, equal to a string, or equal to an integer.
      - `after` string, date-time — After the specified timestamp.
      - `before` string, date-time — Before the specified timestamp
      - `equals` object — The value is equal to the provided string or integer.
        - `integerValues` Integer[] — The list of integer values that the filter matches.
        - `stringValues` StringListMemberString[] — The list of string values that the filter matches.
    - `key` string, required — The key that you're filtering on.
  - `maxResults` integer — The maximum number of results per page.
  - `nextToken` string — The pagination token to continue to the next page of results.

## Response `200`

Success

- ListIncidentRecordsOutput
  - `incidentRecordSummaries` IncidentRecordSummary[], required — The details of each listed incident record.
    - `arn` string, required — The Amazon Resource Name (ARN) of the incident.
    - `creationTime` string, date-time, required — The time the incident was created.
    - `impact` integer, required — Defines the impact to customers and applications.
    - `incidentRecordSource` object, required — What caused Incident Manager to create the incident.
      - `createdBy` string, required — The principal that started the incident.
      - `invokedBy` string — The service principal that assumed the role specified in <code>createdBy</code>. If no service principal assumed the role this will be left blank.
      - `resourceArn` string — The resource that caused the incident to be created.
      - `source` string, required — The service that started the incident. This can be manually created from Incident Manager, automatically created using an Amazon CloudWatch alarm, or Amazon EventBridge event.
    - `resolvedTime` string, date-time — The time the incident was resolved.
    - `status` 'OPEN' | 'RESOLVED', required — The current status of the incident.
    - `title` string, required — The title of the incident. This value is either provided by the response plan or overwritten on creation.
  - `nextToken` string — The pagination token to continue to the next page of results.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/ssm-incidents.md) · [All operations](https://skmtc.net/aws/apis/ssm-incidents/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ssm-incidents/versions/18d598f1fa32/schema)