list_form_responses
List submitted responses from a Google Form with response IDs, timestamps, and answer counts. Use pagination to browse or export responses.
Instructions
List submitted responses for a Google Form with basic metadata (response IDs, timestamps, answer counts). Paginated.
Use this to discover response IDs and submission times, then call
get_form_response with a specific responseId to pull the full
answer payload. For the form's structure (questions, options),
use get_form.
Requires OAuth scope: https://www.googleapis.com/auth/forms.responses.readonly.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_google_email | Yes | The user's Google email address. Required. | |
| form_id | Yes | The form ID — the string after `/forms/d/` in the edit URL. | |
| page_size | No | Maximum number of responses per page. Defaults to 10. Google's hard cap is 5000; practical cap depends on response payload size. Use smaller values (10–100) for UI-facing calls and larger (500–5000) for batch export. | |
| page_token | No | Opaque token from a prior call's `Next page token` line. Omit to fetch the first page. Tokens are one-shot — never reuse the same token across sessions. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |