Tby Typeform
Retrieve responses
Returns a form's responses with their answers and landing and submission times, filtered by date, response type or a search phrase.
Description
Pass `since` to pull only the leads that arrived after the last run, and `response_type` to include partial responses. 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, so use a webhook for real-time leads. The MCP server has no equivalent: its `insights-*` tools return aggregates or one field at a time.
retrieve-responses.md
Retrieve responses
Returns a form's responses with their answers and landing and submission times, filtered by date, response type or a search phrase.
Pass since to pull only the leads that arrived after the last run, and
response_type to include partial responses. 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,
so use a webhook for real-time leads. The MCP server has no equivalent: its
insights-* tools return aggregates or one field at a time.
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 doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | GET /forms/{form_id}/responses | API key in $TYPEFORM_API_KEY | Docs |