FormsList forms

List forms

Needs: Forms, Read

Lists forms: name, tags, step and field counts, whether it is published (public or internal), whether it is used as the incident or prospect form, and the submission count. Most recently updated first.

Note: used_as is incident or prospect when the form is set up as one of those forms. Fields with no value are left out.

curl -X GET "https://app.imploy.com.au/api/integrations/v1/forms?query=example_string&tag=example_string&published=true&page=25&per_page=25" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": [
    {
      "id": 14,
      "name": "Visit feedback",
      "tags": [
        "Feedback"
      ],
      "steps": 2,
      "fields": 9,
      "published": "public",
      "submissions": 31,
      "updated_at": "2026-02-28 04:12:00"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "last_page": 1
  }
}
GET
/forms
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.

An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.
query
querystring

Match a form name.

query
tagstring

Only forms with this tag.

query
publishedboolean

Only published, or only unpublished, forms.

query
pageinteger

Page number, 1 or greater.

query
per_pageinteger

1 to 50. Defaults to 25.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.

Query Parameters

querystring

Match a form name.

tagstring

Only forms with this tag.

publishedboolean

Only published, or only unpublished, forms.

pageinteger

Page number, 1 or greater.

per_pageinteger

1 to 50. Defaults to 25.

Responses

OK