- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
List a form's responses.
HTTP request
GET https://forms.googleapis.com/v1/forms/{formId}/responses
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
formId |
Required. ID of the Form whose responses to list. |
Query parameters
Parameters | |
---|---|
filter |
Which form responses to return. Currently, the only supported filters are:
which means to get all form responses submitted after (but not at) timestamp 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". |
pageSize |
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 |
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. |
Request body
The request body must be empty.
Response body
Response to a ListFormResponsesRequest.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"responses": [
{
object ( |
Fields | |
---|---|
responses[] |
The returned form responses. Note: The |
nextPageToken |
If set, there are more responses. To get the next page of responses, provide this as |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/forms.responses.readonly
For more information, see the Authorization guide.