BizKitHub
DocsAPI ReferenceForm/api/v1/form/detail
getFormPublic API v1

/api/v1/form/detail

Returns form definition with all active fields, their types, labels, and validation rules. Throws PUBLIC_FORM_DOES_NOT_EXIST if the form is not found or inactive.

formgetApiV1FormDetail

Parameters

2 query

Query parameters

· 2
apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

ExamplePRODPGrFxpGEtrOZfuWhnoJohUYBXuOE
codestringOptional

Unique form code identifier.

Examplecontact-form

Response schema

1 status code documented

200SuccessForm definition.
idstringRequired

Form code (unique identifier).

Examplecontact-form
namestringRequired

Display name of the form.

ExampleContact Form
descriptionstringOptional

Form description or instructions.

fieldsobject[]Required

Ordered list of active form fields.

Each array item:
keystringRequired

Field key used for form submission.

Examplesemailmessage
typestringRequired

Field type.

Examplestextemailtextareaselectcheckbox
labelstringRequired

Human-readable field label.

ExampleYour email
helperTextstringOptional

Additional helper text shown below the field.

requiredbooleanRequired

Whether the field is required.

defaultValuestringOptional

Pre-filled default value.

optionsobjectOptional

Key-value map of options for select/radio fields.

Response example

application/json
{
  "id": "contact-form",
  "name": "Contact Form",
  "description": "example_description",
  "fields": [
    {
      "key": "email",
      "type": "text",
      "label": "Your email",
      "helperText": "example_helperText",
      "required": false,
      "defaultValue": "example_defaultValue",
      "options": {}
    }
  ]
}

Request example

GET /api/v1/form/detail

get
curl -X GET "https://api.bizkithub.com/api/v1/form/detail?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&code=contact-form" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key