---
title: "List subscribers for a form"
method: GET
path: "/v4/forms/{form_id}/subscribers"
tags: ["Forms"]
---

# List subscribers for a form

`GET /v4/forms/{form_id}/subscribers`

Returns a cursor-paginated list of subscribers who joined through (or were added to) the form. By default only `active` subscribers are returned — use `status` (`active`, `inactive`, `bounced`, `complained`, `cancelled`, or `all`) to widen the search.

Filter by when they were added to the form with `added_after`/`added_before`, or by when the subscriber record was created with `created_after`/`created_before`. Set `slim=true` to omit expensive optional fields for a faster, smaller response.

## Path parameters

- `form_id` integer, required

## Query parameters

- `added_after` string, nullable
- `added_before` string, nullable
- `after` unknown
- `before` unknown
- `created_after` string, nullable
- `created_before` string, nullable
- `include_total_count` boolean
- `per_page` unknown
- `slim` boolean
- `status` 'active' | 'inactive' | 'bounced' | 'complained' | 'cancelled' | 'all'

## Response `200`

Returns a paginated list of subscribers for the specified form

- object
  - `subscribers` object[], required
    - `id` integer, required
    - `first_name` string, nullable, required
    - `email_address` string, required
    - `state` 'active' | 'cancelled' | 'bounced' | 'complained' | 'inactive', required
    - `created_at` string, required
    - `added_at` string, required
    - `fields` object, required
      - `category` string, nullable, required
    - `referrer` string, required
    - `referrer_utm_parameters` object, required
      - `source` string, required
      - `medium` string, required
      - `campaign` string, required
      - `term` string, required
      - `content` string, required
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `404` — Returns a 404 when the provided id does not exist

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/revisions/0df0c90d12da/schema)