---
title: "List the checklist items of a Runway release"
method: GET
path: "/app/{appId}/release/{releaseId}/checklistItems"
tags: ["release"]
---

# List the checklist items of a Runway release

`GET /app/{appId}/release/{releaseId}/checklistItems`

## Request

- Base URL: `https://api.runway.team`
- URL: `https://api.runway.team/app/{appId}/release/{releaseId}/checklistItems`
- Auth: API key in header `X-API-Key`

Returns a flat list of every checklist item for a release, covering both Flightpaths step runs (for migrated archetypes) and legacy checklist items (for archetypes still on the legacy model).

## Path parameters

- `appId` string, required
- `releaseId` string, required

## Response `200`

A list of checklist items for a release

- ChecklistItemEntity[]
  - `id` string, required: The identifier of the checklist item
  - `title` string, required: The title of the checklist item
  - `description` string: The description of the checklist item. Accepts markdown.
  - `approverGroups` UserGroup[], required: The list of user groups that can approve this checklist item. Custom groups can be included as well.
  - `releaseType` 'all' | 'hotfixOnly' | 'rollbackOnly' | 'allExceptHotfix', required: The type of release this checklist item will appear on
  - `notifyEnabled` boolean, required: Whether the checklist item will notify on Slack when its status changes
  - `statuses` ChecklistItemStatusType[], required: The list of possible checklist item status types for this checklist item. A subset of all possible ChecklistItemStatusType values
  - `releaseStepType` string: The release step that the checklist item appears on. Will be `null` if the placement of the item is not `binary`. Can either be of type ReleaseStepType, or a step's Step ID can be sent instead
  - `stepId` unknown
  - `oneOffForVersion` string: If the checklist item only applies for a single release version, this field will contain the version string for that version
  - `status` ChecklistItemStatus: The status of a checklist item
    - `status` 'approved' | 'rejected' | 'inProgress' | 'blocked' | 'passed' | 'failed', required: All possible statuses for a checklist item
    - `createdBy` string, required: The userId (email) of the user that created the checklist item
    - `createdAt` string, date-time, required: The date and time the checklist item was created
  - `placement` 'stepChecklist' | 'approvals' | 'regressionTesting', required: The placement of a given checklist item
  - `comment` ChecklistItemComment: A comment on a checklist item
    - `createdAt` string, date-time
    - `createdBy` string: The user id (email) of the user that added the comment
    - `comment` string: The comment string. Can be markdown.

## Other responses

- `400`: Bad request response
- `404`: Resource not found response

---

[API](https://skmtc.dev/runway/apis/runway-rest-api.md) - [All operations](https://skmtc.dev/runway/apis/runway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runway/apis/runway-rest-api/revisions/081109863a9a?raw)