Retrieve responses

GET https://api.typeform.com/forms/:form_id/responses?page_size={{page_size}}&since={{since}}&until={{until}}&after={{after}}&before={{before}}&included_response_ids={{included_response_ids}}&excluded_response_ids={{excluded_response_ids}}&completed={{completed}}&sort={{sort}}&query={{query}}&fields={{fields}}&answered_fields={{answered_fields}}

Request Params

KeyDatatypeRequiredDescription
page_sizestringMaximum number of responses. Default value is 25. Maximum value is 1000. If your typeform has fewer than 1000 responses, you can retrieve all of the responses in a single request by adding the page_size parameter. If your typeform has more than 1000 responses, use the since/until or before/after query parameters to narrow the scope of your request.
sincestringLimit request to responses submitted since the specified date and time. Could be passed as int (timestamp in seconds) or in ISO 8601 format, UTC time, to the second, with T as a delimiter between the date and time (2020-03-20T14:00:59).
untilstringLimit request to responses submitted until the specified date and time. Could be passed as int (timestamp in seconds) or in ISO 8601 format, UTC time, to the second, with T as a delimiter between the date and time (2020-03-20T14:00:59).
afterstringLimit request to responses submitted after the specified token. Could not be used together with sort parameter, as it sorts responses in the order that our system processed them (submitted_at). This ensures that you can traverse the complete set of responses without repeating entries.
beforestringLimit request to responses submitted before the specified token. Could not be used together with sort parameter, as it sorts responses in the order that our system processed them (submitted_at). This ensures that you can traverse the complete set of responses without repeating entries.
included_response_idsstringLimit request to the specified responseid values. Use a comma-separated list to specify more than one responseid value.
excluded_response_idsstringComma-separated list of response_ids to be excluded from the response.
completedstringLimit responses only to those which were submitted. This parameter changes since/until filter, so if completed=true, it will filter by submittedat, otherwise - landedat.
sortstringResponses order in {fieldID},{asc
querystringLimit request to only responses that include the specified string. The string will be escaped and it will be matched aganist all answers fields, hidden fields and variables values.
fieldsstringShow only specified fields in answers section. If response does not have answers for specified fields, there will be null. Use a comma-separated list to specify more than one field value.
answered_fieldsstringLimit request to only responses that include the specified fields in answers section. Use a comma-separated list to specify more than one field value - response will contain at least one of the specified fields.

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring