BizKitHub
DocsAPI ReferenceForm/bff/form/list
getFormAdmin BFF

/bff/form/list

Returns a paginated list of forms for the organisation, ordered by last update. Each form includes its record count (number of submissions).

FormgetBffFormList

Parameters

2 query

Query parameters

· 2
pagestringOptional

Page number (1-based) for pagination.

Example1
limitstringOptional

Maximum items per page (1–500, default 50).

Example50

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
idstringRequired

Form code (unique identifier within the organisation).

namestringRequired

Form display name.

descriptionstringOptional

Form description.

activebooleanRequired

Whether the form is active and accepting submissions.

recordCountnumberRequired

Number of submitted records.

insertedDateDate | string | string | numberRequired

When the form was created.

One of 4:
Variant 1
Date

When the form was created.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
updatedDateDate | string | string | numberRequired

Last update.

One of 4:
Variant 1
Date

Last update.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
itemCountnumberRequired

Total number of forms (for pagination).

Response example

application/json
{
  "items": [
    {
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "active": false,
      "recordCount": 0
    }
  ],
  "itemCount": 0
}

Request example

GET /bff/form/list

get
curl -X GET "https://api.bizkithub.com/bff/form/list?page=1&limit=50" \
  -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