---
title: "List Follow-ups V2"
method: GET
path: "/v2/follow_ups"
tags: ["Follow-ups V2"]
---

# List Follow-ups V2

`GET /v2/follow_ups`

List all follow-ups for an organisation.

## Query parameters

- `incident_id` string
- `incident_mode` 'standard' | 'retrospective' | 'test' | 'tutorial' | 'stream'

## Response `200`

OK response.

- FollowUpsV2ListResponseBody
  - `follow_ups` FollowUpV2[], required
    - `assignee` UserV2
      - `email` string — Email address of the user.
      - `id` string, required — Unique identifier of the user
      - `name` string, required — Name of the user
      - `role` 'viewer' | 'responder' | 'administrator' | 'owner' | 'unset', required — DEPRECATED: Role of the user as of March 9th 2023, this value is no longer updated.
      - `slack_user_id` string — Slack ID of the user
    - `completed_at` string, date-time — When the follow-up was completed
    - `created_at` string, date-time, required — When the follow-up was created
    - `description` string — Description of the follow-up
    - `external_issue_reference` ExternalIssueReferenceV2
      - `issue_name` string, required — Human readable ID for the issue
      - `issue_permalink` string, required — URL linking directly to the action in the issue tracker
      - `provider` 'asana' | 'click_up' | 'linear' | 'jira' | 'jira_server' | 'github' | 'gitlab' | 'shortcut', required — ID of the issue tracker provider
    - `id` string, required — Unique identifier for the follow-up
    - `incident_id` string, required — Unique identifier of the incident the follow-up belongs to
    - `priority` FollowUpPriorityV2
      - `description` string — Description of the follow-up priority option
      - `id` string, required — Unique identifier for the follow-up priority option
      - `name` string, required — Name of the follow-up priority option
      - `rank` integer, required — Rank is used to order the follow-up priority options correctly
    - `status` 'outstanding' | 'completed' | 'deleted' | 'not_doing', required — Status of the follow-up
    - `title` string, required — Title of the follow-up
    - `updated_at` string, date-time, required — When the follow-up was last updated

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)