GET
/smart-formsList Smart Forms
Retrieve a paginated list of smart forms for the authenticated user
Scope: SMART_FORMS_READ
Overview
Returns a paginated list of all smart forms owned by the API key's user. Supports filtering by publish status and keyword search across title and purpose.
Request
GET
/smart-formsHeaders
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Query Parameters
Example Request
curl -X GET "https://api.formfex.com/api/v1/public/smart-forms?page=1&limit=10&status=PUBLISHED" \
-H "Authorization: Bearer $FORMFEX_API_KEY"Response
Response Fields
| Field | Type | Description |
|---|---|---|
smartForms | array | Array of smart form objects |
smartForms[].id | string (UUID) | Unique smart form identifier |
smartForms[].title | string | Display title |
smartForms[].purpose | string | Purpose prompt used to generate questions |
smartForms[].description | string | null | Respondent-facing description |
smartForms[].targetAudience | string | null | Target audience description |
smartForms[].languages | string[] | Configured language codes |
smartForms[].maxQuestions | number | Maximum questions per session |
smartForms[].isPrivate | boolean | Whether email OTP is required |
smartForms[].publishStatus | string | DRAFT or PUBLISHED |
smartForms[].allowNewSessions | boolean | Whether new sessions can be started |
smartForms[].shortId | string | Short ID used in the public share URL |
smartForms[]._count.sessions | number | Total number of sessions |
total | number | Total matching smart forms (for pagination) |
Pagination
Use total with page and limit to compute whether more pages exist: hasMore = page * limit < total.
n8n
In n8n, this operation is available as Get Many under the Smart Form resource in the Formfex node.