Skip to content

Form

Read-only access to forms in your account. A form is the central resource — it contains an ordered list of questions (each with its own type, settings, and optional choices), visual design settings (colours, fonts, theme), behavioural settings (captcha, drafts, multi-page steps), logo configuration, and one or more thank-you pages shown after submission. Use these endpoints to inspect form structure and sync it with external systems.

Operations

List all forms

Request

Returns a list of all forms that belong to the authenticated account.

Each item in the returned array contains the form's unique identifier (_id) and its title. Use _id with the GET /form/{id} endpoint to retrieve the full structure of a specific form including questions, design, and settings.

Forms are returned regardless of their visibility state (public, unlisted, or private) as long as they belong to the authenticated user and are not in the trash or archived.

Security
BearerAuth or ApiKeyAuth
curl -i -X GET \
  https://developers.forms.app/_mock/apis/v1/form \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

List of forms returned successfully.

Bodyapplication/json
successboolean

Always true for successful responses.

Value:true
dataArray of objects(FormListItem)

The response payload. Shape depends on the endpoint.

errorsArray of any, <= 0 items

Always an empty array on success.

Response
{
  "success": true,
  "data": [
    { … }
  ],
  "errors": []
}