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

# forms_responses_list

> List a form's submitted responses, newest page first, up to 5000 per page. The only supported filter is on submission time: pass filter='timestamp >= 2026-01-01T00:00:00Z' to read what has arrived since a point in time. Answers come back keyed by questionId.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://forms.googleapis.com/v1/forms/{formId}/responses"}</code></div>

```python gforms_forms_responses_list.py theme={null}
from charter.packs import gforms

result = await gforms.forms_responses_list.ainvoke({"formId": ...})
```

<Note>
  Requires `https://www.googleapis.com/auth/forms.responses.readonly`. Pages by cursor: `nextPageToken` is sent back as `pageToken`. Costs 1 against the provider's own quota.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                          | Type     | Description                                       |
  | -------------------------------------------------------------- | -------- | ------------------------------------------------- |
  | `formId` <span className="required" title="required">\*</span> | `string` | Required. ID of the Form whose responses to list. |
</div>

## Query parameters

<div className="reference-table">
  | Field       | Type      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | ----------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `filter`    | `string`  | Which form responses to return. Currently, the only supported filters are: `timestamp &gt; N` which means to get all form responses submitted after (but not at) timestamp N, and `timestamp &gt;= N` which means to get all form responses submitted at and after timestamp N. For both supported filters, timestamp must be formatted in RFC3339 UTC "Zulu" format. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z". The whole filter is one string, operator included: 'timestamp >= 2014-10-02T15:01:23Z'. There is no other filterable field — a question, an email or a score cannot be filtered here. |
  | `pageSize`  | `integer` | The maximum number of responses to return. The service may return fewer than this value. If unspecified or zero, at most 5000 responses are returned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | `pageToken` | `string`  | A page token returned by a previous list response. If this field is set, the form and the values of the filter must be the same as for the original request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
</div>