FormsGet a form

Get a form

Needs: Forms, Read

Returns a form outline: steps, fields (id, type, label, required, options, visibility), routing, settings, incident, prospect and pre-fill mappings, the link, and any issues. Use step_id or field_id to get one step or one field in full.

Note: The outline also lists the steps with their fields. published is public, internal or off, and url is the live link when the form is published.

curl -X GET "https://app.imploy.com.au/api/integrations/v1/forms/123?step_id=example_string&field_id=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": 14,
  "name": "Visit feedback",
  "description": "Collect feedback after a visit.",
  "published": "off",
  "url": null,
  "settings": {
    "allow_step_navigation": false,
    "show_step_numbers": true,
    "submit_button_text": "Submit"
  }
}
GET
/forms/{id}
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
step_idstring

Return this step in full.

query
field_idstring

Return this field in full.

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.

Path Parameters

idinteger
Required

The form id.

Query Parameters

step_idstring

Return this step in full.

field_idstring

Return this field in full.

Responses

OK