---
title: "List Followups"
method: GET
path: "/api/v1/admin/followups/"
tags: ["admin-followups"]
---

# List Followups

`GET /api/v1/admin/followups/`

## Query parameters

- `tab` string — due|scheduled|sent|suppressed|failed
- `rule` string, nullable — Filter by rule slug
- `search` string, nullable — Customer name/email/company
- `project_id` string, uuid, nullable — Scope to one project (project detail panel)
- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- PaginatedResponseFollowupTaskListItem
  - `items` FollowupTaskListItem[], required
    - `id` string, uuid, required
    - `rule_slug` string, required
    - `audience` string, required
    - `category` string, required
    - `status` string, required
    - `user_id` string, uuid, required
    - `customer_name` string, required
    - `customer_email` string, required
    - `company` string, nullable, required
    - `project_id` string, uuid, nullable, required
    - `project_name` string, nullable, required
    - `quote_id` string, uuid, nullable, required
    - `due_at` string, date-time, nullable, required
    - `sent_at` string, date-time, nullable, required
    - `snoozed_until` string, date-time, nullable, required
    - `eligibility_reason` string, nullable, required
    - `suppression_reason` string, nullable, required
    - `failure_reason` string, nullable, required
    - `retry_count` integer, required
    - `email_to` string, nullable, required
    - `subject_snapshot` string, nullable, required
    - `provider_status` string, nullable, required
    - `created_at` string, date-time, required
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/prototyping/apis/prototyping-io-api.md) · [All operations](https://skmtc.dev/prototyping/apis/prototyping-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prototyping/prototyping-io-api/revisions/f4a0079fbb57/schema)