---
title: "List forms"
method: GET
path: "/v4/forms"
tags: ["Forms"]
---

# List forms

`GET /v4/forms`

Returns a cursor-paginated list of forms and landing pages in the account. Both live on this endpoint — filter with `type=embed` for embedded forms or `type=hosted` for landing pages. By default only `active` forms are returned; use `status` (`active`, `archived`, `trashed`, or `all`) to widen the search. Add `include=subscriber_count` to embed each form's subscriber count.

Each form includes its `uid`, `embed_js`, and `embed_url` for embedding on your site. To see who joined via a form, use [List subscribers for a form](/api-reference/forms/list-subscribers-for-a-form); to add an existing subscriber, use [Add subscriber to form](/api-reference/forms/add-subscriber-to-form).

## Query parameters

- `after` unknown
- `before` unknown
- `include_total_count` boolean
- `per_page` unknown
- `status` 'active' | 'archived' | 'trashed' | 'all', nullable
- `type` unknown
- `include` string

## Response `200`

Returns a paginated list of all forms and landing pages (embedded and hosted) for your account (including active and archived)

- object
  - `forms` object[], required
    - `id` integer, required
    - `name` string, required
    - `created_at` string, required
    - `type` string, required
    - `format` unknown, required
    - `embed_js` string, required
    - `embed_url` string, required
    - `archived` boolean, required
    - `uid` string, required
    - `subscriber_count` integer — Returned when `include` contains `subscriber_count`. The number of active subscribers who subscribed via this form.
  - `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

---

[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)