---
name: "forms_list"
area: "forms"
title: "List forms"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/forms_list"
mcp_server: "https://api.conecto.chat/mcp/forms"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/forms/forms_list"
---

# List forms (`forms_list`)

The business's forms, newest first, with their links, whether each takes responses, and their response counts.

The account's forms, newest first, with their public links, whether each is taking responses, and their response counts.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

To find a form's slug, or see which forms are live.

## Say this to your agent

> Which of our forms are live right now?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `status` | string | no |  | `"open"`, `"closed"`, `"any"` | `"any"` |
| `limit` | integer | no | 1 to 200. |  | `50` |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `forms_list` on the MCP server `https://api.conecto.chat/mcp/forms` with these arguments:

```json
{
  "status": "open"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/forms_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "open"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "forms_list",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "forms": [
      {
        "form_id": "cccc059a-0b2b-48d1-90b0-7a9df3913b95",
        "slug": "repair-feedback",
        "url": "https://cncto.co/f/repair-feedback",
        "title": "Repair feedback",
        "status": "open",
        "accepting_responses": true,
        "closed_reason": null,
        "responses": 2,
        "last_response_at": "2026-10-14T08:00:00+00:00",
        "created_at": "2026-10-14T08:00:00+00:00"
      },
      {
        "form_id": "45d7857f-c2e4-4f6f-9f45-88a779773387",
        "slug": "join-the-ride-club",
        "url": "https://cncto.co/f/join-the-ride-club",
        "title": "Join the ride club",
        "status": "open",
        "accepting_responses": true,
        "closed_reason": null,
        "responses": 1,
        "last_response_at": "2026-10-14T08:00:00+00:00",
        "created_at": "2026-10-14T08:00:00+00:00"
      }
    ],
    "count": 2,
    "monthly_responses": {
      "month": "2026-10",
      "received": 3,
      "limit": 10000,
      "reached": false,
      "resets_on": "2026-11-01"
    }
  }
}
```

`result`: Up to 200 forms, newest first, each with its form_id, slug, url, title, status, whether it takes responses and response count, and the responses received this month.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [forms_create](https://conecto.chat/tools/forms/forms_create.md): Creates a form or survey with its own public page that anyone can open and answer. $0.01 a call.
- [forms_update](https://conecto.chat/tools/forms/forms_update.md): Changes a form's fields or settings; only what you pass changes. $0.01 a call.
- [forms_get](https://conecto.chat/tools/forms/forms_get.md): One form with its fields, settings, public link, whether it takes responses (and why not) and its response count. Free up to 1,000,000 reads a month.
- [forms_list_responses](https://conecto.chat/tools/forms/forms_list_responses.md): A form's responses, newest first, each answer with its question and a readable value. Free up to 1,000,000 reads a month.
- [forms_get_response](https://conecto.chat/tools/forms/forms_get_response.md): One response by its response_id, with every answer readable. Free up to 1,000,000 reads a month.
- [forms_summary](https://conecto.chat/tools/forms/forms_summary.md): A form's results at a glance: choice counts, rating averages, the NPS score, yes and no shares, numbers and the latest text answers. Free up to 1,000,000 reads a month.
- [forms_export_responses](https://conecto.chat/tools/forms/forms_export_responses.md): Saves a CSV of a form's responses in the file store and returns a download link. $0.001 a call.
- [forms_close](https://conecto.chat/tools/forms/forms_close.md): Stops a form taking responses; its page then says it is closed. $0.001 a call.
- [forms_open](https://conecto.chat/tools/forms/forms_open.md): Lets a closed form take responses again. $0.001 a call.
- [forms_delete](https://conecto.chat/tools/forms/forms_delete.md): Deletes a form and all its responses for good; its link stops working. $0.001 a call.
- [forms_delete_response](https://conecto.chat/tools/forms/forms_delete_response.md): Deletes one response for good, for a person who asks to be forgotten, or for spam. Free.