Get Form
Retrieve a form and its field definitions.
Settings:
URL | Method |
|---|---|
| JSON via GET |
Authorization:
Header Parameter | Description |
|---|---|
| User API key; access depends on the user's permissions. |
Path Parameters:
Parameter | Description | Required |
|---|---|---|
| Account identifier. | Yes |
| Form identifier in the path. | Yes |
Request Example:
curl -s -H "api_access_token: $TOKEN" "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/forms/$FORM"Response:
This abbreviated example shows two of the 16 fields in the supplied response.
{
"id": "90",
"name": "new form",
"description": null,
"status": "published",
"created_at": "2026-09-23T11:06:05.330Z",
"updated_at": "2026-09-23T11:06:05.330Z",
"fields": [
{"id": "text", "type": "text", "name": "text", "label": "Text field", "required": true},
{"id": "email", "type": "email", "name": "email", "label": "Email", "required": false}
]
}Response-Explain:
Parameter | Description |
|---|---|
| Form identifier (string). |
| Form name. |
| Form description. |
| Form status. Enum: |
| Creation timestamp in ISO 8601 format. |
| Last update timestamp in ISO 8601 format. |
| Array of field definitions. |
| Field identifier; corresponds to |
| Field type. Enum: |
| Field name. |
| Display label. |
| Boolean indicating whether the field is required. |