Forms¶

Important

The API is a work in progress. GET requests have been implemented in the current version, but POST, UPDATE, and DELETE support is not yet complete.

Get list of forms¶

Description¶

This endpoint returns a list of all forms existing in an application on the specified domain.

Request¶

GET /liveforms/api/domains/{domain}/apps/{appliation_id}/forms

Parameter	Description
domain	The name of a valid domain which the authenticated user has access to.
application_id	The id of an application in the domain.

Response¶

Possible HTTP response codes:

Code	Description
200 OK	Success
401 UNAUTHORIZED	The username/password used for authentication was invalid.
404 NOT FOUND	The specified domain or application does not exist.
500 SERVER ERROR	The request failed due to an internal server error.

If the request is successful, a JSON (default) or XML payload will be returned containing the requested information.

Example JSON response

{
   "title": "Forms",
   "link": {
      "rel": "self",
      "href": "/liveforms/api/domains/demo/apps/1/forms"
   },
   "entry": [{
      "id": "1",
      "name": "Form 1",
      "description": "This is a demo form",
      "modified": "2017-01-01 13:00:00",
      "link": [{
            "rel": "self",
            "href": "/liveforms/api/domains/demo/apps/1/forms/1"
         }
      ]
   }]
}

Example XML response

<?xml version="1.0" encoding="UTF-8"?>
<feed>
   <title>Forms</title>
   <link rel="self" href="/liveforms/api/domains/demo/apps/1/forms"/>
   <entry>
      <id>1</id>
      <name>Form 1</name>
      <description>This is a demo form</description>
      <modified>2017-01-01 13:00:00</modified>
      <link rel="self" href="/liveforms/api/domains/demo/apps/1/forms/1"/>
   </entry>
</feed>

Get form by ID¶