Retrieve responses

Retrieve responses

Returns a form's responses with their answers and landing and submission times, filtered by date, response type or a search phrase.

Note: Forms with more than 1,000 responses need narrower since and until ranges or the before and after cursors. Responses from the last 30 minutes or so may be missing: use a webhook for real-time leads.

Set up

Use the first option your agent supports.

API (official)

• Base URL: https://api.typeform.com
• Endpoint: GET /forms/{form_id}/responses
• Auth: send the header Authorization: Bearer $TYPEFORM_API_KEY
• Get a key: https://admin.typeform.com/user/tokens
• Docs: https://www.typeform.com/developers/get-started/

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.