Skip to main content
GET
/
api
/
public
/
forms
/
{formId}

Get Form

Returns the complete form definition including fields, validation rules, and display settings. Used to render the form for user input.

Authentication

No authentication required for public forms.

Path Parameters

formId
string
required
Unique identifier (GUID) of the form.

Query Parameters

_shape
string
Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation.

Response

Returns the form configuration object with the following fields.

Form Fields

Identity

FieldTypeDescription
IdnumberUnique numeric identifier for the form
UniqueIdstringGlobally unique identifier

Core

FieldTypeDescription
NamestringForm display name
DescriptionstringForm description / instructions
ActivebooleanWhether the form is active

Questions

Each form contains an array of question objects:
FieldTypeDescription
IdnumberQuestion identifier
TextstringQuestion text
DescriptionstringQuestion description / help text
QuestionTypestringType of question (e.g. Text, Select)
AvailableOptionsstringComma-separated list of options
AvailableOptionsArraystring[]Array of option strings
DisplayOrdernumber | nullSort order of the question
AllowMultipleOptionsbooleanWhether multiple selections are allowed
IsRequiredbooleanWhether the question is required

Timestamps (from base)

FieldTypeDescription
CreatedOnstringDate created (business-local time)
UpdatedOnstring | nullDate last updated (business-local time)
CreatedOnUtcstringDate created (UTC)
UpdatedOnUtcstring | nullDate last updated (UTC)

TypeScript Integration

import endpoints from '@/api/endpoints'

const response = await httpClient.get(endpoints.forms.show('abc123'))