GET
/forms/:id/responsesList Responses
Retrieve a paginated list of form responses
Scope: RESPONSES_READ
Overview
Returns a paginated list of submissions for a specific form. Supports date range filtering and ordering.
Request
GET
/forms/:id/responsesPath Parameters
Query Parameters
Headers
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Example Request
curl -X GET "https://api.formfex.com/api/v1/public/forms/FORM_ID/responses?page=1&limit=20&order=newest_first" \
-H "Authorization: Bearer $FORMFEX_API_KEY"Response
Response Fields
| Field | Type | Description |
|---|---|---|
data.items | Response[] | Array of response objects |
data.items[].id | string | Unique response identifier (UUID) |
data.items[].formId | string | Form identifier |
data.items[].data | object | Key-value map of fieldId to submitted answer |
data.items[].respondentEmail | string | null | Email of the respondent (only set for private forms) |
data.items[].submittedAt | string | ISO 8601 submission timestamp |
data.total | number | Total matching responses |
data.page | number | Current page |
data.limit | number | Current page size |
data.hasMore | boolean | true if more pages are available |
Incremental Sync
Use the since parameter with the timestamp of the last response you received. When both since and startDate are provided, since takes precedence.
n8n
In n8n, this operation is available as Get Many under the Response resource in the Formfex node.