Get a list of Templates, reverse ordered by created date. Use parameters to filter the list.
GET https://utilityapi.com/api/v2/templates
# Get a list of all Templates curl -H 'Authorization: Bearer API_TOKEN_HERE' \ 'https://utilityapi.com/api/v2/templates'
# Get some specific templates 123 and 456 curl -H 'Authorization: Bearer API_TOKEN_HERE' \ 'https://utilityapi.com/api/v2/templates?uids=123,456'
# Get all enabled Templates curl -H 'Authorization: Bearer API_TOKEN_HERE' \ 'https://utilityapi.com/api/v2/forms?disabled=false'
Parameter | Format | Description | Example |
---|---|---|---|
uids |
List(UID String) | Filter by Template uids. Separate with commas (, ). |
uids=123,456 |
disabled |
Boolean | Filter by disabled state. | disabled=false |
after |
UID String | List items after this Template uid. | after=456-3 |
disabled=true&uids=...
), the returned
list will be of Templates that are those uids that are disabled (so the list
may be empty if there are no overlaps).
Returns a TemplateListing object containing a list of Template objects. If the number of results is over 1000, a next parameter will have the link to the next in the series of lists.
// Example result { "templates": [ {"uid": "12837438", "created": ...}, {"uid": "12837438", "created": ...}, ... ], "next": null, }
This is the object that contains the Templates results for the request. We don't just return a straight list of results so that we can paginate results if needed. Currently, the maximum results per request is set at 1000.
Parameter | Format | Description | Example |
---|---|---|---|
templates |
List(Template) | List of Template results. | [{"uid": ...}, ...] |
next |
URL or
null
|
If there are more results than the page limit, this is a link to the next set of results. | "https://utilityapi.com/api/v2/templates?after=234" |
// Example TemplateListing { "templates": [...], "next": null, }
Code | Response Format | Description |
---|---|---|
200 |
TemplateListing | Successful request. |
400 |
Error |
The query parameters included are malformed. Check the error
in the response for the type of error:
|
401 |
Error |
Invalid or missing access_token . See our docs on
Authentication for
how to properly use your access_token .
|
429 |
N/A |
The request was rate limited.
Check the Retry-After response header for how long to wait
until retrying the request. Do not expect any specific response format for
this error (could be html, json, or nothing).
|
500 |
N/A | Internal server error. Do not expect any specific response format for this error (could be html, json, or nothing). This error is logged and will be fixed by our engineers. |
503 |
N/A | Site is currently down for maintenance. Do not expect any specific response format for this error (could be html, json, or nothing). |
504 |
N/A | We tried to build this request but timed out. Please try again later. Do not expect any specific response format for this error (could be html, json, or nothing). |