Surveys API

List surveys

List all surveys for an account:

GET /surveys

Response

status: 200 OK
[
  {
    "id": 1,
    "name": "My Survey",
    "created_at": "2021-07-21T06:41:06-05:00",
    "updated_at": "2021-07-21T06:41:06-05:00",
    "nodeID": "..."
  },
  "..."
]

The response contains these fields by default. Filtering and pagination are available to reduce/limit the collection of surveys.

Predefined Filters

The following predefined filters are available:

Collection Fields

By default the following fields will appear in collections of surveys:

id name created_at updated_at

Obtain a different set of fields using the ?fields= parameter.

Filtering

Filtering is available for the following fields:

id source sourceID created_at updated_at disabled name

Sorting

By default a collection of surveys is sorted ascending by id.

The following fields are accepted by the ?sort= parameter:

id sourceID created_at updated_at

Get a single survey

GET /surveys/:id

Response

status: 200 OK
{
  "completion": null,
  "created_at": "2021-07-21T06:41:07-05:00",
  "disabled": false,
  "id": 12,
  "introduction": null,
  "name": "My Survey",
  "source": null,
  "sourceID": null,
  "updated_at": "2021-07-21T06:41:07-05:00",
  "...": "..."
}

The response contains these fields.

Create a survey

POST /surveys

When creating a new survey these fields are available.

Response

status: 201 Created
{
  "name": "...",
  "...": "..."
}

The response contains all fields of the created survey and is similar to the response in Get a single survey.

Update a survey

PATCH /surveys/:id

When updating an survey these fields are available.

Response

status: 200 OK
{
  "name": "...",
  "...": "..."
}

The response contains all fields of the updated survey and is similar to the response in Get a single survey.

Fields

attachments
Readonly aggregated Attachments
created_at
Readonly datetime — The date and time at which the survey was created.
completion
Optional text (max 64KB) — The Completion field is used to enter content shown to respondents on completion of the survey.
completion_attachments
Writeonly attachments The attachments used in the Completion field.
disabled
Optional boolean, default: false — The Disabled box is checked when the survey may no longer be related to services and users should not be asked to use it to rate services it is linked to.
id
Readonly integer — The unique ID of the survey.
introduction
Optional text (max 64KB) — The Introduction field is used to enter content shown to respondents before the first question of the survey.
introduction_attachments
Writeonly attachments The attachments used in the Introduction field.
name
Required string (max 128) — The Name field is used to enter the name of the survey.
source
Optional string (max 30) - See source
sourceID
Optional string (max 128) - See source
updated_at
Readonly datetime — The date and time of the last update of the survey. If the survey has no updates it contains the created_at value.