GET
/formsList Forms
Retrieve a paginated list of all your forms
Scope: FORMS_READ
Overview
Returns a paginated list of forms owned by the authenticated API key's account. Results are ordered by updatedAt descending (most recently updated first).
Request
GET
/formsQuery Parameters
Headers
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Example Request
curl -X GET "https://api.formfex.com/api/v1/public/forms?page=1&limit=10&search=feedback" \
-H "Authorization: Bearer $FORMFEX_API_KEY"Response
Response Fields
| Field | Type | Description |
|---|---|---|
data.forms | FormSummary[] | Array of form summary objects |
data.forms[].id | string | Unique form identifier (UUID) |
data.forms[].title | string | Form title |
data.forms[].description | string | null | Form description from schema metadata |
data.forms[].publishStatus | string | DRAFT, PUBLISHED, or ARCHIVED |
data.forms[].publishVisibility | string | PUBLIC or PRIVATE |
data.forms[].publishedAt | string | null | ISO 8601 timestamp when the form was published |
data.forms[].shareUrl | string | null | Short sharing slug (10 characters), null if not published |
data.forms[].expiresAt | string | null | ISO 8601 expiry timestamp |
data.forms[].updatedAt | string | ISO 8601 last update timestamp |
data.forms[].meta | object | null | Form metadata (title, description, language, etc.) |
data.forms[].settings | object | null | Form settings (layout, submit action, etc.) |
data.total | number | Total matching forms across all pages |
data.hasMore | boolean | true if more pages are available |
Schema Not Included
The list endpoint returns form summaries without the full schema object. Use the Get Form endpoint to retrieve the complete form schema with fields and sections.
Notes
Incremental Sync
Use the since parameter with the timestamp from your last sync to fetch only new or updated forms. This is especially useful for n8n and Zapier polling triggers.
n8n
In n8n, this operation is available as Get Many under the Form resource in the Formfex node.