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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List form responses

> List one page of normalized Google Form responses with timestamp filtering.

`listFormResponses` returns one provider page and can filter by submission
time. Use it for backfills and explicit pagination.

## Example

```ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { listFormResponses } from "automate.ax/google-forms"

export default automation("List today's responses", () => {
  onHttpRequest({ scope: "automation" })

  listFormResponses({
    form: "form-id",
    submittedAtOrAfter: "2026-08-05T00:00:00-07:00",
    pageSize: 500,
  })
})
```

## Inputs

| Property                | Type                     | Required | Default          | Description                                                         |
| ----------------------- | ------------------------ | -------- | ---------------- | ------------------------------------------------------------------- |
| `form`                  | `string`                 | Yes      | —                | Form ID or standard Forms URL.                                      |
| `includeQuestionTitles` | `boolean`                | No       | `true`           | Fetch form metadata to attach question titles and display ordering. |
| `pageSize`              | `number`                 | No       | Provider default | Requested page size from 1–5,000; Google may return fewer.          |
| `pageToken`             | `string`                 | No       | —                | Token from a previous page.                                         |
| `submittedAtOrAfter`    | RFC 3339 `string`        | No       | —                | Inclusive submission boundary.                                      |
| `submittedAfter`        | RFC 3339 `string`        | No       | —                | Exclusive submission boundary.                                      |
| `account`               | Google account reference | No       | Project default  | Connected account.                                                  |

Use only one timestamp boundary. Automate.ax converts it to UTC for Google's
supported response filter syntax.

## Output

Returns `{ responses: FormResponse[]; nextPageToken?: string }`. See [Get form
response](/reference/integrations/google-forms/actions/get-form-response#output)
for each response. Follow `nextPageToken` to retrieve the complete result set.