> ## 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 Applications

> List form submissions (applications) for your organization

# List Applications

Returns a paginated list of form submissions. Each application is one user's response to a form.

**Required scope:** `applications: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">Comma-separated. Allowed: `Draft`, `Pending`, `Accepted`, `Rejected`. Defaults to all four.</ParamField>
<ParamField query="form_id" type="string">Filter to applications submitted to a specific form.</ParamField>
<ParamField query="contact_id" type="string">Filter to applications submitted by a specific contact.</ParamField>
<ParamField query="updated_from" type="string">ISO-8601 timestamp. Only return applications updated at or after this time. Use with `updated_to` for incremental sync.</ParamField>
<ParamField query="updated_to" type="string">ISO-8601 timestamp. Only return applications updated at or before this time.</ParamField>

## Response

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

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

    <ResponseField name="contact_id" type="string | null">The submitter's contact ID</ResponseField>
    <ResponseField name="user_id" type="string | null">The submitter's user ID, if signed in</ResponseField>
    <ResponseField name="status" type="string | null">`Draft`, `Pending`, `Accepted`, `Rejected`</ResponseField>

    <ResponseField name="answers" type="array">
      <Expandable title="Answer">
        <ResponseField name="question_id" type="string | null">Matches the `id` of a question on the form</ResponseField>

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

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

        <ResponseField name="answer" type="any">String, number, ISO date, array, or object depending on `type`</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="payment_id" type="string | null">Linked payment, if the form requires payment</ResponseField>
    <ResponseField name="metadata" type="object">Free-form integration data. Keys are client-defined and never interpreted by Gomry. Writable via [Update Application](/api-reference/applications/update-application). Empty object if never set.</ResponseField>
    <ResponseField name="utm_source" type="string | null">`utm_source` captured from the form URL at submission time</ResponseField>
    <ResponseField name="utm_medium" type="string | null">`utm_medium` captured from the form URL at submission time</ResponseField>
    <ResponseField name="utm_campaign" type="string | null">`utm_campaign` captured from the form URL at submission time</ResponseField>
    <ResponseField name="utm_content" type="string | null">`utm_content` captured from the form URL at submission time</ResponseField>
    <ResponseField name="utm_term" type="string | null">`utm_term` captured from the form URL at submission time</ResponseField>

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

    <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/applications?form_id=FORM_ID&status=Accepted"
  ```
</RequestExample>