When a participant completes a survey, it generates a Survey Result. Each survey result contains multiple step results (corresponding to each step of the survey), and each step result can contain multiple child results (answers to questions, results produced by active tasks, etc.). In some cases (e.g., instruction steps, or if a step was skipped)—a step result may not have any child results.
Survey Result Component Data
In the CSV export, multiple data files are produced for survey results for the different survey result components, with keys that can be used for cross referencing. In the JSON export, all of the results are contained in a single file and data structure.
For more information about how to cross-reference data across the different survey result components, see Using Exported Data. For more information about the other components, see the following topics:
- Survey Step Results Export Format
- Survey Question Results Export Format
- Survey Consent Signature Results Export Format
- Survey Tasks Export Format
Data Fields
| Field | Description |
|---|---|
SurveyResultKey |
A unique, auto-generated key for this result. Can be used to cross reference with other survey results. |
SurveyKey |
A unique, auto-generated key for the survey which will not change if the survey name changes. |
SurveyName |
The name of the survey this result was for. |
SurveyVersion |
Identifies which version of the survey was active at the time the data was collected. This allows you to adapt data processing if your survey changes. |
ParticipantIdentifier |
The identifier of the participant this task was for. Can be used to cross reference with Participants. |
SurveyTaskKey |
The key for the task used to deliver this survey. Can be used to cross reference with Survey Tasks. Will be empty for “Consent” survey results - results captured during the consent process do not have a survey task. |
Type |
One of “Survey” or “Consent.” |
StartDate |
The timestamp for when the participant began taking the survey, in ISO 8601 format. Includes timezone offset information. |
EndDate |
The timestamp for when the participant finished taking the survey, in ISO 8601 format. Includes timezone offset information. |
DevicePlatform |
The platform the survey was completed on, e.g. “iOS”, “Android.” |
DeviceName |
The name of the device used to complete the survey, e.g. “iPhone 8,2.” |
DeviceOSVersion |
The operating system version running on the device used to complete the version, e.g. “11.2.5.” |
InsertedDate |
The creation date of the result, in ISO 8601 format. Is always in UTC. |
Sample CSV Export
SurveyResultKey,SurveyKey,SurveyName,SurveyVersion,ParticipantIdentifier,SurveyTaskKey,Type,StartDate,EndDate,DevicePlatform,DeviceName,DeviceOSVersion,InsertedDate 73b25dbd-e9d9-e711-815b-b9576bf93116,dcbede15-67c9-e711-815a-a2abfc96a420,Consent,0,81a5ca06-6bdb-423e-9ed7-49d81aa4be2a,,Consent,2017-12-05T13:25:47-05:00,2017-12-05T13:25:58-05:00,iOS,"iPhone7,1",10.0,2017-12-05T18:25:59Z 9ada96e5-e9d9-e711-815b-b9576bf93116,75a665cb-e3a7-e711-8159-cb0f82935acb,SF-12,5,81a5ca06-6bdb-423e-9ed7-49d81aa4be2a,a6b25dbd-e9d9-e711-815b-b9576bf93116,Survey,2017-12-05T13:26:58-05:00,2017-12-05T13:27:12-05:00,iOS,"iPhone7,1",10.0,2017-12-05T18:27:12Z 0d684d39-0d05-e811-815d-8bcb67ef5edd,dcbede15-67c9-e711-815a-a2abfc96a420,Consent,0,8d87da94-ed15-4be3-a69a-41f6c6cfcfef,,Consent,2018-01-29T10:58:05-05:00,2018-01-29T10:58:19-05:00,iOS,"iPhone7,1",10.0,2018-01-29T15:58:20Z
Sample JSON Export
{
"SurveyResultKey": "73b25dbd-e9d9-e711-815b-b9576bf93116",
"SurveyKey": "dcbede15-67c9-e711-815a-a2abfc96a420",
"SurveyName": "Consent",
"ParticipantIdentifier": "81a5ca06-6bdb-423e-9ed7-49d81aa4be2a",
"Type": "Consent",
"SurveyVersion": 0,
"StartDate": "2017-12-05T13:25:47-05:00",
"EndDate": "2017-12-05T13:25:58-05:00",
"DevicePlatform": "iOS",
"DeviceName": "iPhone7,1",
"DeviceOSVersion": "10.0",
"InsertedDate": "2017-12-05T18:25:59Z",
"StepResults": [
{
"SurveyStepResultKey": "79b25dbd-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "CONSENT",
"StartDate": "2017-12-05T13:25:47-05:00",
"EndDate": "2017-12-05T13:25:57-05:00",
"Results": [
{
"Type": "ConsentSignatureResult",
"ConsentSignatureResultKey": "7fb25dbd-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "Participant",
"Consented": true,
"Signature": {
"Identifier": "Participant",
"Title": "Participant",
"GivenName": "Chris",
"FamilyName": "Nksak",
"Date": "12/5/17"
},
"StartDate": "2017-12-05T13:25:47-05:00",
"EndDate": "2017-12-05T13:25:57-05:00"
}
]
},
{
"SurveyStepResultKey": "7ab25dbd-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "END",
"StartDate": "2017-12-05T13:25:57-05:00",
"EndDate": "2017-12-05T13:25:58-05:00",
"Results": []
}
]
}
{
"SurveyResultKey": "9ada96e5-e9d9-e711-815b-b9576bf93116",
"SurveyKey": "75a665cb-e3a7-e711-8159-cb0f82935acb",
"SurveyName": "SF-12",
"ParticipantIdentifier": "81a5ca06-6bdb-423e-9ed7-49d81aa4be2a",
"SurveyTaskKey": "a6b25dbd-e9d9-e711-815b-b9576bf93116",
"Type": "Survey",
"SurveyVersion": 5,
"StartDate": "2017-12-05T13:26:58-05:00",
"EndDate": "2017-12-05T13:27:12-05:00",
"DevicePlatform": "iOS",
"DeviceName": "iPhone7,1",
"DeviceOSVersion": "10.0",
"InsertedDate": "2017-12-05T18:27:12Z",
"StepResults": [
{
"SurveyStepResultKey": "a0da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "INSTRUCTION_SF12",
"StartDate": "2017-12-05T13:26:58-05:00",
"EndDate": "2017-12-05T13:26:59-05:00",
"Results": []
},
{
"SurveyStepResultKey": "a1da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_HEALTH",
"StartDate": "2017-12-05T13:26:59-05:00",
"EndDate": "2017-12-05T13:27:00-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "b7da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_HEALTH",
"Answers": [
""
],
"StartDate": "2017-12-05T13:26:59-05:00",
"EndDate": "2017-12-05T13:27:00-05:00"
}
]
},
{
"SurveyStepResultKey": "a2da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_ACTIVITY",
"StartDate": "2017-12-05T13:27:01-05:00",
"EndDate": "2017-12-05T13:27:01-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "bada96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_ACTIVITY",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:01-05:00",
"EndDate": "2017-12-05T13:27:01-05:00"
}
]
},
{
"SurveyStepResultKey": "a3da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_STAIRS",
"StartDate": "2017-12-05T13:27:01-05:00",
"EndDate": "2017-12-05T13:27:02-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "bdda96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_STAIRS",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:01-05:00",
"EndDate": "2017-12-05T13:27:02-05:00"
}
]
},
{
"SurveyStepResultKey": "a4da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_ACCOMP_PH",
"StartDate": "2017-12-05T13:27:02-05:00",
"EndDate": "2017-12-05T13:27:02-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "c0da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_ACCOMP_PH",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:02-05:00",
"EndDate": "2017-12-05T13:27:02-05:00"
}
]
},
{
"SurveyStepResultKey": "a5da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_LIMIT",
"StartDate": "2017-12-05T13:27:02-05:00",
"EndDate": "2017-12-05T13:27:03-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "c3da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_LIMIT",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:02-05:00",
"EndDate": "2017-12-05T13:27:03-05:00"
}
]
},
{
"SurveyStepResultKey": "a6da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_ACCOMP_MH",
"StartDate": "2017-12-05T13:27:03-05:00",
"EndDate": "2017-12-05T13:27:03-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "c6da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_ACCOMP_MH",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:03-05:00",
"EndDate": "2017-12-05T13:27:03-05:00"
}
]
},
{
"SurveyStepResultKey": "a7da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_CAREFUL",
"StartDate": "2017-12-05T13:27:03-05:00",
"EndDate": "2017-12-05T13:27:04-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "c9da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_CAREFUL",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:03-05:00",
"EndDate": "2017-12-05T13:27:04-05:00"
}
]
},
{
"SurveyStepResultKey": "a8da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_PAIN",
"StartDate": "2017-12-05T13:27:04-05:00",
"EndDate": "2017-12-05T13:27:04-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "ccda96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_PAIN",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:04-05:00",
"EndDate": "2017-12-05T13:27:04-05:00"
}
]
},
{
"SurveyStepResultKey": "a9da96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "INSTRUCTION_FEELING",
"StartDate": "2017-12-05T13:27:04-05:00",
"EndDate": "2017-12-05T13:27:05-05:00",
"Results": []
},
{
"SurveyStepResultKey": "aada96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_CALM",
"StartDate": "2017-12-05T13:27:05-05:00",
"EndDate": "2017-12-05T13:27:06-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "d1da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_CALM",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:05-05:00",
"EndDate": "2017-12-05T13:27:06-05:00"
}
]
},
{
"SurveyStepResultKey": "abda96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_ENERGY",
"StartDate": "2017-12-05T13:27:06-05:00",
"EndDate": "2017-12-05T13:27:07-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "d4da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_ENERGY",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:06-05:00",
"EndDate": "2017-12-05T13:27:07-05:00"
}
]
},
{
"SurveyStepResultKey": "acda96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_BLUE",
"StartDate": "2017-12-05T13:27:07-05:00",
"EndDate": "2017-12-05T13:27:07-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "d7da96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_BLUE",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:07-05:00",
"EndDate": "2017-12-05T13:27:07-05:00"
}
]
},
{
"SurveyStepResultKey": "adda96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "E_SOCIAL",
"StartDate": "2017-12-05T13:27:07-05:00",
"EndDate": "2017-12-05T13:27:08-05:00",
"Results": [
{
"Type": "QuestionResult",
"QuestionResultKey": "dada96e5-e9d9-e711-815b-b9576bf93116",
"ResultIdentifier": "E_SOCIAL",
"Answers": [
""
],
"StartDate": "2017-12-05T13:27:07-05:00",
"EndDate": "2017-12-05T13:27:08-05:00"
}
]
},
{
"SurveyStepResultKey": "aeda96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "INSTRUCTION_THANKYOU",
"StartDate": "2017-12-05T13:27:08-05:00",
"EndDate": "2017-12-05T13:27:10-05:00",
"Results": []
},
{
"SurveyStepResultKey": "afda96e5-e9d9-e711-815b-b9576bf93116",
"StepIdentifier": "New Step 16",
"StartDate": "2017-12-05T13:27:10-05:00",
"EndDate": "2017-12-05T13:27:12-05:00",
"Results": []
}
]
}
{
"SurveyResultKey": "5f959ec6-192e-e811-815d-8bcb67ef5edd",
"SurveyKey": "dcbede15-67c9-e711-815a-a2abfc96a420",
"SurveyName": "Consent",
"ParticipantIdentifier": "f5e23bf1-29d6-437e-b7e0-4d9bbeea4eaa",
"Type": "Consent",
"SurveyVersion": 0,
"StartDate": "2018-03-22T17:41:19-04:00",
"EndDate": "2018-03-22T17:41:28-04:00",
"DevicePlatform": "iOS",
"DeviceName": "iPhone8,2",
"DeviceOSVersion": "11.3",
"InsertedDate": "2018-03-22T21:41:28Z",
"StepResults": [
{
"SurveyStepResultKey": "66959ec6-192e-e811-815d-8bcb67ef5edd",
"StepIdentifier": "CONSENT",
"StartDate": "2018-03-22T17:41:19-04:00",
"EndDate": "2018-03-22T17:41:27-04:00",
"Results": [
{
"Type": "ConsentSignatureResult",
"ConsentSignatureResultKey": "6c959ec6-192e-e811-815d-8bcb67ef5edd",
"ResultIdentifier": "Participant",
"Consented": true,
"Signature": {
"Identifier": "Participant",
"Title": "Participant",
"GivenName": "Chris",
"FamilyName": "Smith",
"Date": "3/22/18"
},
"StartDate": "2018-03-22T17:41:19-04:00",
"EndDate": "2018-03-22T17:41:27-04:00"
}
]
},
{
"SurveyStepResultKey": "67959ec6-192e-e811-815d-8bcb67ef5edd",
"StepIdentifier": "END",
"StartDate": "2018-03-22T17:41:27-04:00",
"EndDate": "2018-03-22T17:41:28-04:00",
"Results": []
}
]
}