Get Survey Response
Returns detailed information about a single survey response, including all question answers, metadata, and geolocation data.
Endpoint
GET
v5/survey/{survey_id}/surveyresponse/{response_id}
Requires authentication
Path Parameters
The survey and specific response to retrieve.
survey_id
string
required
The ID of the survey the response belongs to.
response_id
string
required
The ID of the specific response to retrieve.
Query Parameters
This endpoint does not accept additional query parameters beyond authentication credentials.
None
Response
Returns a single survey response object.
result_ok
boolean
Whether the request succeeded.
id
string
The unique ID of the response.
contact_id
string
The contact ID associated with the response, if any.
status
string
The response status. Possible values:
Complete, Partial, Disqualified.is_test_data
string
Whether this response is flagged as test data.
"1" = test, "0" = real.date_submitted
string
Timestamp when the response was submitted (EST/EDT).
date_updated
string
Timestamp when the response was last updated. Does not include timezone information — typically UTC, but may vary by account settings.
date_started
string
Timestamp when the respondent began the survey (EST/EDT).
session_id
string
Unique session identifier for the response.
language
string
Language the survey was taken in.
link_id
string
The ID of the survey campaign link used to access the survey.
url_variables
array
Any URL variables passed in when the survey was accessed. Empty array if none.
ip_address
string
IP address of the respondent.
referer
string
The URL the respondent came from when starting the survey.
user_agent
string
Browser/device user agent string of the respondent.
response_time
integer
Time in seconds the respondent spent on the survey.
data_quality
array | object
Data quality flags for the response. Returns an empty array
[] if no issues are detected, or an object with nested quality check results (e.g. opentext.gibberish) if issues are found.longitude
string
Estimated longitude of the respondent based on IP geolocation.
latitude
string
Estimated latitude of the respondent based on IP geolocation.
country
string
Country of the respondent based on IP geolocation.
city
string
City of the respondent based on IP geolocation.
region
string
State or region of the respondent based on IP geolocation.
postal
string
Postal code of the respondent based on IP geolocation.
dma
string
Designated Market Area code based on IP geolocation.
survey_data
object
Keyed object of question response data, where each key is the question ID. Contains one entry per question in the survey.
child attributes
id
integer
The question ID.
type
string
The question type (e.g.
TEXTBOX, ESSAY, HIDDEN).question
string
The question title or label.
section_id
integer
The page/section ID the question belongs to.
answer
string | null
The respondent's answer. Returns
null if not answered or not shown.shown
boolean
Whether the question was shown to the respondent. Hidden questions (e.g. from skip logic) return
false.Examples
Note GET requests are cached for 60 seconds. Repeated identical requests within that window will return cached results.
Request (cURL)
curl -X GET "https://api.alchemer.com/v5/survey/8611799/surveyresponse/121?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"id": "121",
"contact_id": "",
"status": "Complete",
"is_test_data": "0",
"date_submitted": "2025-12-09 17:15:37 EST",
"date_updated": "2025-12-09 17:15:43",
"date_started": "2025-12-09 17:15:30 EST",
"session_id": "1765318530_69389f82343073.85490891",
"language": "English",
"link_id": "24839672",
"url_variables": [],
"ip_address": "204.132.224.66",
"referer": "https://app.alchemer.com/",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36",
"response_time": 6,
"data_quality": [],
"longitude": "-105.01560211182",
"latitude": "39.907299041748",
"country": "United States",
"city": "Denver",
"region": "CO",
"postal": "80234",
"dma": "751",
"survey_data": {
"2": {
"id": 2,
"type": "TEXTBOX",
"question": "First Name",
"section_id": 1,
"answer": "Ian",
"shown": true
},
"3": {
"id": 3,
"type": "TEXTBOX",
"question": "Last Name",
"section_id": 1,
"answer": "Reed",
"shown": true
},
"4": {
"id": 4,
"type": "TEXTBOX",
"question": "Department",
"section_id": 1,
"answer": "Support",
"shown": true
},
"82": {
"id": 82,
"type": "HIDDEN",
"question": "teams_message",
"section_id": 10,
"answer": null,
"shown": false
},
"5": {
"id": 5,
"type": "ESSAY",
"question": "Query Result",
"section_id": 4,
"answer": "A single row was successfully found.\n\nStatus code: 200\nRecord count: 1\n\nResult: {\"employee_id\":1009,\"first_name\":\"Ian\",\"last_name\":\"Reed\",\"email\":\"[email protected]\",\"department\":\"Support\",\"hire_date\":\"2020-12-13\",\"salary\":58000,\"is_active\":true}",
"shown": true
},
"6": {
"id": 6,
"type": "ESSAY",
"question": "Email Address",
"section_id": 4,
"answer": "