---
ref: tool:typeform/retrieve-responses
name: Retrieve responses
company: company:typeform
workflows: [workflow:inbound-lead-to-meeting, workflow:inbound-lead-routing, workflow:promoter-case-studies, workflow:nps-detractor-rescue]
access: [api]
tags: [capability:collect-responses, category:forms, has:api]
docs: https://www.typeform.com/developers/responses/reference/retrieve-responses/
updated: 2026-10-28
---

# 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.