This article contains the description of all summarised survey reports as well as an example of the data included in each report.
Each report is returned as a CSV (Comma Separated Values) formatted string.
In this article we cover:
- Multichoice survey question report
- Numeric survey question report
- Open text survey question report
- Pin on image survey question report
- Ranking survey question report
- Rating-scale survey question report
Multichoice survey question report
Type ID: survey-multichoice
Version: v2 & v1 (returns the same data for both versions)
This report lists each question choice per row.
| Column title | Description |
| accessCode | Session ID |
| surveyId | Survey ID |
| surveyName | Survey name |
| questionId | Question ID |
| questionText | Question text |
| choiceText | Choice text |
| voteCount | Number of votes this choice has received |
| voteTotal | Total number of responses to this question |
| votePercentage | Percentage of the votes this choice has received |
Report example:
"accessCode","surveyId","surveyName","questionId","questionText","choiceText","voteCount","voteTotal","votePercentage"
"200100103","b13793c3-7348-4fc8-bd7b-c6c182f8a3e4","New Survey","3b6ca736-3c6b-408b-96e9-7aaa342bf37c","What is your favourite food?","Pizza","499","2000","24.9500"
"200100103","b13793c3-7348-4fc8-bd7b-c6c182f8a3e4","New Survey","3b6ca736-3c6b-408b-96e9-7aaa342bf37c","What is your favourite food?","Hamburger","501","2000","25.0500"
"200100103","b13793c3-7348-4fc8-bd7b-c6c182f8a3e4","New Survey","3b6ca736-3c6b-408b-96e9-7aaa342bf37c","What is your favourite food?","Fish","501","2000","25.0500"
"200100103","b13793c3-7348-4fc8-bd7b-c6c182f8a3e4","New Survey","3b6ca736-3c6b-408b-96e9-7aaa342bf37c","What is your favourite food?","Pasta","499","2000","24.9500"Numeric survey question report
Type ID: survey-numeric
Version: v2 (contains answers for numeric input questions only, rating survey questions has its own report id survey-rating in v2)
Version: v1 (contains answers for both numeric input and rating survey questions)
This report lists each question per row.
| Column title | Description |
| accessCode | Session ID |
| surveyId | Survey ID |
| surveyName | Survey name |
| questionId | Question ID |
| questionText | Question text |
| averageResponse | Average response |
| highestResponse | Highest response |
| lowestResponse | Lowest response |
| answerCount | Number of answers received for this question |
| medianResponse | The middle number in a set of values when those values are arranged from smallest to largest. (v2 only) |
| modeResponse | The most frequently repeated value(s) in the dataset, as a comma-separated list. (v2 only) |
Report example, v2:
"accessCode","surveyId","surveyName","questionId","questionText","averageResponse","highestResponse","lowestResponse","answerCount","medianResponse","modeResponse"
"134170523","6974fa66-6ab1-426e-b3a4-ca343390f58f","New Survey","5ff0c5ad-412e-49f5-82a3-a022631d221a","Numeric Q","55.5","56","55","6","55.5","55,56"
"200100103","b13793c3-7348-4fc8-bd7b-c6c182f8a3e4","New Survey","0b9e9cd6-9d65-4f11-b747-187d6ceb21f8","Enter a number between 1 and 100","50.2315","100","1","2000","50","50"Report example, v1:
"accessCode","surveyId","surveyName","questionId","questionText","averageResponse","highestResponse","lowestResponse","answerCount"
"134170523","6974fa66-6ab1-426e-b3a4-ca343390f58f","New Survey","5ff0c5ad-412e-49f5-82a3-a022631d221a","Numeric Q","55.5","56","55","6"
"200100103","b13793c3-7348-4fc8-bd7b-c6c182f8a3e4","New Survey","0b9e9cd6-9d65-4f11-b747-187d6ceb21f8","Enter a number between 1 and 100","50.2315","100","1","2000"
"200100103","b13793c3-7348-4fc8-bd7b-c6c182f8a3e4","New Survey","582359cc-c917-43e6-9fb0-0e595b0234a9","How would you rate todays session?","3.0095","5","1","2000"Open text survey question report
Type ID: survey-opentext
Version: v2 & v1 (returns the same data for both versions)
This report lists each question answer per row.
| Column title | Description |
| accessCode | Session ID |
| surveyId | Survey ID |
| surveyName | Survey name |
| questionId | Question ID |
| questionText | Question text |
| responseText | The respondents answer |
Report example:
"accessCode","surveyId","surveyName","questionId","questionText","responseText"
"134170523","6974fa66-6ab1-426e-b3a4-ca343390f58f","New Survey","055d6986-0401-4e02-8f7a-ef597800e646","How did you like this meeting?","Interesting"
"134170523","6974fa66-6ab1-426e-b3a4-ca343390f58f","New Survey","055d6986-0401-4e02-8f7a-ef597800e646","How did you like this meeting?","Very nice"
"134170523","6974fa66-6ab1-426e-b3a4-ca343390f58f","New Survey","055d6986-0401-4e02-8f7a-ef597800e646","How did you like this meeting?","I enjoyed this meeting very much thank you"
Pin on image survey question report
Type ID: survey-pinonimage
Version: v2
This report lists each unique question answer point per row.
| Column title | Description |
| accessCode | Session ID |
| surveyId | Survey ID |
| surveyName | Survey name |
| questionId | Question ID |
| questionText | Question text |
| choiceText | Choice text, if a predefined choice/pin, otherwise empty |
| answerPointX | Relative X coordinate for the answer point [0.0 : 1.0] (image width) |
| answerPointY | Relative Y coordinate for the answer point [0.0 : 1.0] (image hieght) |
| voteCount | Number of votes this answer point has received |
| voteTotal | Total number of responses to this question |
| votePercentage | Percentage of the votes this answer point has received |
Report example:
"accessCode","surveyId","surveyName","questionId","questionText","choiceText","answerPointX","answerPointY","voteCount","voteTotal","votePercentage"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","6c6a5df1-cc79-42c0-a583-c5fb5f2118f0","Survey Pin","","0.42","0.41","1","2","50.0000"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","6c6a5df1-cc79-42c0-a583-c5fb5f2118f0","Survey Pin","","0.45","0.36","1","2","50.0000"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","a2172022-13d6-4000-aa8e-0f11d1022fde","Image choice","Choice 1","0.1","0.3","2","3","66.6667"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","a2172022-13d6-4000-aa8e-0f11d1022fde","Image choice","Choice 2","0.563","0.787","1","3","33.3333"
Ranking survey question report
Type ID: survey-ranking
Version: v2
This report lists each question choice per row.
| Column title | Description |
| accessCode | Session ID |
| surveyId | Survey ID |
| surveyName | Survey name |
| questionId | Question ID |
| questionText | Question text |
| choiceText | Choice text |
| mostCommonRank | Most common rank for the choice |
| timesRanked | Number of times the choice has received a rank |
Report example:
"accessCode","surveyId","surveyName","questionId","questionText","choiceId","choiceText","mostCommonRank","timesRanked"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","8970af95-a092-48f5-981e-131598411552","Ranking survey preference","1c9dc4dd-6898-4ad2-842b-9fa76e61f2e2","CS1","1","2"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","8970af95-a092-48f5-981e-131598411552","Ranking survey preference","1a5f5fbd-9f9a-42ca-adff-dccaf6d9e721","CS2","2","1"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","8970af95-a092-48f5-981e-131598411552","Ranking survey preference","5215e6aa-ffec-4e25-9c78-d4a2350b51f2","CS3","1","1"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","a83273b3-e405-4c1d-b245-449fa06488a6","Ranking survey order","69b50e6a-9784-42ab-a9c7-7861b2d99279","CS1","1","2"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","a83273b3-e405-4c1d-b245-449fa06488a6","Ranking survey order","15728960-574d-4aff-ae43-e5f42a0ccbef","CS2","3","2"
"170552051","d0a1259c-00c7-4b55-8c53-d45bfb7bc4a3","Survey 1","a83273b3-e405-4c1d-b245-449fa06488a6","Ranking survey order","bb0f1074-a257-486b-b090-3775dd89570c","CS3","2","2"
Rating-scake survey question report
Type ID: survey-rating-scale
Version: v2
This report lists each question per row.
| Column title | Description |
| accessCode | Session ID |
| surveyId | Survey ID |
| surveyName | Survey name |
| questionId | Question ID |
| questionText | Question text |
| itemText | Item text |
| answerCount | Number of answers received for this item |
| averageResponse | Average response |
| medianResponse | The middle number in a set of values when those values are arranged from smallest to largest. |
| modeResponse | The most frequently repeated value(s) in the dataset, as a comma-separated list. |
Report example:
"accessCode","surveyId","surveyName","questionId","questionText","itemText","answerCount","averageResponse","medianResponse","modeResponse"
"201817605","6ede2107-d6ef-4c12-b641-43bceb3c1ae6","Rating scale test","6d02280e-e9e7-4f21-bd8d-667a7e8859a7","Rate the animals","Cats","3","4.00","4.00",""
"201817605","6ede2107-d6ef-4c12-b641-43bceb3c1ae6","Rating scale test","6d02280e-e9e7-4f21-bd8d-667a7e8859a7","Rate the animals","Dogs","3","4.33","4.00","4.00"