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

# List Forms

> List forms (registration questionnaires) for your organization

# List Forms

Returns a paginated list of forms belonging to your organization. Forms include the question schema you'll use to interpret answers from the [Applications](/api-reference/applications/list-applications) endpoint.

**Required scope:** `forms:read`

## Query Parameters

<ParamField query="page" type="integer" default="1" />

<ParamField query="page_size" type="integer" default="50">Maximum: `200`.</ParamField>
<ParamField query="status" type="string" default="active">Comma-separated. Allowed: `active`, `inactive`.</ParamField>

## Response

<ResponseField name="data" type="array">
  <Expandable title="Form object">
    <ResponseField name="id" type="string" />

    <ResponseField name="name" type="string | null" />

    <ResponseField name="description" type="string | null" />

    <ResponseField name="status" type="string | null">`active`, `inactive`</ResponseField>

    <ResponseField name="cover_image" type="string | null" />

    <ResponseField name="questions" type="array">
      <Expandable title="Question">
        <ResponseField name="id" type="string | null" />

        <ResponseField name="title" type="string | null" />

        <ResponseField name="subtitle" type="string | null" />

        <ResponseField name="type" type="string | null">e.g. `text`, `multipleChoice`, `dropdown`, `email`, `contact_custom_field`</ResponseField>
        <ResponseField name="user_info" type="string | null">If this question maps to a contact field (e.g. `email`, `linkedin`)</ResponseField>

        <ResponseField name="required" type="boolean" />

        <ResponseField name="options" type="string[]">For `multipleChoice` and `dropdown`</ResponseField>
        <ResponseField name="field_id" type="string | null">For `contact_custom_field`, the custom field ID</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string | null" />

    <ResponseField name="updated_at" type="string | null" />
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "X-API-KEY: your_api_key" "https://www.gomry.com/api/v1/forms"
  ```
</RequestExample>