# List Incident Updates

Filters and returns Incident Update records for specific Incident and current Hub with basic info.

Endpoint: GET /hubs/{subdomain}/incidents/{incident_id}/incident_updates
Version: 3.0-R1
Security: ApiKeyAuth

## Path parameters:

  - `subdomain` (string, required)
    Unique subdomain of requested Hub.

  - `incident_id` (integer, required)
    id of the requested incident.

## Query parameters:

  - `archived` (string)
    Filters incident updates by archived status:
* true - return only incident updates that were archived,
* false - return only incident updates that were not archived,
* all - return incident updates without filtering by archived status.
    Enum: "true", "false", "all"

  - `q` (string)
    String that filters events to those containing the search string in:
- title,
- body.

  - `extend` (string)
    Specifies which properties should be expanded. Expanded properties contains more detailed information which is less frequently needed in typical usage. Currently supported only for flags.
    Example: "flags"

  - `sort_prop` (string)
    Determines which property results should be sorted by.
    Enum: "start_time", "created_at", "updated_at"

  - `sort_dir` (string)
    Determines sorting direction.
    Enum: "asc", "desc"

  - `page` (integer)
    Requested page index.

  - `per_page` (integer)
    A limit on the number of records to be returned.

  - `api_version` (string)
    Api version
    Enum: "V3-R1"

## Response 200 fields (application/json):

  - `current_page` (integer)
    Example: 1

  - `page_count` (integer)
    Example: 4

  - `per_page` (integer)
    Example: 25

  - `total` (integer)
    Example: 1024

  - `data` (array)

  - `data.id` (integer)
    Example: 16

  - `data.title` (string)
    Title of this update. May be different from current incident title. Incident title may be changed during the duration of incident and therefore some updates may reflect previous title.

  - `data.incident_type` (string)
    Type of Incident Update. Exact meaning may depend on use case and there is just one restriction: resolved can't be used as type of a first (by start_time) Incident Update.
    Enum: "investigating", "identified", "monitoring", "resolved"

  - `data.start_time` (string)
    Timestamps of a Incident Update. ISO8601 formatted time (UTC).
    Example: "2020-09-01T08:29:00Z"

  - `data.state` (string)
    Event state
    Enum: "undefined", "draft", "unconfirmed", "published"

  - `data.flags` (any)