API Reference

The v1.0 version of the implementation is restricted to surveys and responses. The v2.0 version mainly adds participant functionality. However, various existing v1.0 endpoints have been changed. These changes will be listed inside [ ] brackets.

Please note that from Monday 5th December 2022 usage of the API becomes chargeable. The charge is that 0.1 unit will be consumed each time a survey response is delivered by the API.  This applies if the same survey response is delivered by the API multiple times. The survey responses are delivered using the Get Survey Responses endpoint.

List of API endpoints in v2.0

EndpointDescription
Get Survey List Returns a list of surveys that are accessible by the user.
Get Survey Returns the details for a specific survey ID.
Get Survey Variables Returns the details for a specific survey ID.
Get Survey Variable Returns the details for a specific variable ID.
Get Survey Responses Gets the responses for a specific survey ID.
Please note that from Monday 5th December 2022 usage of the API becomes chargeable. When one survey response is delivered by the API, 0.1 unit will be consumed.  The survey responses are delivered using the Get Survey Responses endpoint.
Get User Info Returns information for the authenticated user.
Get Participant List Returns a list of participants for a survey.
Get Participant Returns the details for a specific participant in a survey.
Add Participant Add a new participant to a survey.
Update Participant Update an existing participant of a survey.
Delete Participant Delete a participant from a survey.
Get Participants Subjects Returns a list of subjects for a participant of a survey.
Get Participant Subject Returns the details of a specific subject for a participant of a survey.
Add Participant Subject Add a new subject to a participant of a survey.
Update Participant Subject Update an existing subject for a participant of a survey.
Delete Participant Subject Delete a subject from a participant of a survey.

Contents