Query parameters
-
Filter by a comma separated list of UUIDs.
-
Get forms that have or have not been published.
-
Get forms of this visibility value, Available types are 'hidden', 'public', 'private', and 'internal'.
-
Get forms with a title that match this filter.
-
Date to filter when the record was created after.
-
Date to filter when the record was created before.
-
Field to sort by. Valid fields are [created_at, updated_at, title]. Negative sign to denote DESC. Defaults to '-created_at'.
-
Number of results to return with pagination (Default 15. Max 500).
GET
/api/v1/form
curl \
--request GET 'https://api.plannrcrm.com/api/v1/form' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"
Response examples (200)
{
"data": [
{
"uuid": "ed371a4d-c6d9-4b87-bbcf-237b33d20faa",
"created_at": "2026-04-28T22:34:35+01:00",
"updated_at": "2026-04-28T22:34:35+01:00",
"title": "Annual Catchup 2022",
"description": "This is the annual catchup form for 2022",
"live": true,
"visibility": "public",
"sections": {
"uuid": "930dcd81-70df-460b-bfec-c3c8ba0aa4dc",
"created_at": "2026-04-28T22:34:35+01:00",
"updated_at": "2026-04-28T22:34:35+01:00",
"section": "App\\Http\\Resources\\FormSectionResource",
"title": "What is your name?",
"help_text": "Gareth",
"caption": "Your full legal name",
"type": "string",
"required": true,
"position": 1,
"selection_options": [
"option 1",
"option 2"
],
"target_field": "name",
"key": "what_is_your_name",
"linked_question": "App\\Http\\Resources\\FormBuilder\\LinkedFormQuestionResource",
"linked_primary": true
},
"allowed_hosts": [
"domain.com",
"subdomain.domain.com"
],
"draft_submissions_count": 5,
"submitted_submissions_count": 5,
"create_client": true,
"client_type": "client"
}
]
}