Skip to main content

​
Introduction to the /Responses endpoint

The Responses endpoint exposes the session statuses per respondent, as well as enables response management and reconciliations (removals). Named status values on GET /responses map from inbound_code and isc. See Respondent Status Codes.

​
Validating Survey Responses

Given a survey ID, the Responses endpoint details all survey responses processed by the Research Desk system based on respondent redirects. After a survey has been fielded, it is highly encouraged to call the API for all registered survey responses and compare by ID to the survey responses collected within the survey platform.

​
Reconciling Survey Responses

If survey responses which were initially registered as completed sessions are determined to be of poor quality or fraudulent, responses can be reconciled by utilizing the PATCH method available for the Responses endpoint to change the session status. Similarly, if there are survey responses that were completes in your survey platform, but were not registered as completes in Research Desk, you can PATCH these as “accepted” to ensure that the respondents are credited for their time and effort in your survey.