> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Forms

> Retrieves a list of forms for the authenticated workspace.

import { ParamField } from "/snippets/param-field.mdx";

### GET /v1/forms

Retrieves a paginated list of forms within the current workspace.

#### Query Parameters

<ParamField name="status" type="string">
  Filter forms by status. Can be `draft` or `published`.
</ParamField>

<ParamField name="search" type="string">
  Search for forms by name or title.
</ParamField>

<ParamField name="limit" type="integer">
  The maximum number of forms to return. Defaults to `20`.
</ParamField>

<ParamField name="offset" type="integer">
  The number of forms to skip before starting to collect the result set.
</ParamField>

#### Example Request

```bash theme={null}
curl -X GET "https://api.example.com/v1/forms" \
     -H "Authorization: Bearer <YOUR_API_KEY>"
```

#### Example Response

```json theme={null}
{
  "items": [
    {
      "id": "form_123",
      "name": "Contact Form",
      "slug": "contact-form",
      "title": "Contact Us",
      "description": "A simple contact form.",
      "status": "published",
      "fields": [],
      "settings": null,
      "notification_emails": [],
      "created_by": "user_456",
      "created_at": "2023-01-01T00:00:00.000Z",
      "updated_at": "2023-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}
```