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

# List forms

`GET /forms`

## Query parameters

- `query` string

## Response `200`

Successful response

- object
  - `data` Form[]
    - `id` integer
    - `title` string, required
    - `landing_page_id` integer, nullable
    - `redirect_url` string, nullable
    - `gdpr_required` boolean
    - `url` string — Public subscribe URL
    - `lists` ContactList[], required — Attached lists (included on create/update)
      - `id` integer
      - `name` string, required
      - `user_id` integer
      - `average_email_open_percent` number, float
      - `average_email_click_percent` number, float
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `current_page` integer
  - `total` integer
  - `per_page` integer

## Other responses

- `401` — Unauthorized

---

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