LIST

Last Modified on 03/25/2026 6:39 pm EDT |

List Survey Responses

Returns a paginated list of all responses for the specified survey. Deleted responses are excluded from results.

Endpoint

GET v5/survey/{survey_id}/surveyresponse

Requires authentication

Path Parameters

The survey whose responses should be retrieved.

survey_id
string
required
The ID of the survey whose responses will be listed.

Query Parameters

All query parameters are optional.

page
integer
Page number to return. Defaults to 1. Results return 50 per page by default.
resultsperpage
integer
Number of results to return per page. Default is 50, maximum is 500. Values exceeding the limit will fall back to 500.
order_by
string
Sort order for results. Accepted values: date_submitted, -date_submitted, date_updated, -date_updated. Prefix with - for descending; default is ascending.
filters
array
List of filter conditions used to match response fields.
child attributes
field_name
string
The response field to filter by. Accepted values: status, date_submitted, date_updated, is_test_data, [question(n)], [question(n), option(n)], [url("variablename")].
operator
string
The comparison operator to use.
= Is equal to
<> or != Is not equal to
> Greater than
< Less than
<= Less than or equal to
>= Greater than or equal to
IS NOT NULL Is answered / not blank
IS NULL Is not answered / blank
in In comma-separated list
value
string
The value to match against.

Response

Returns a paginated array of survey response objects.

result_ok
boolean
Whether the request succeeded.
total_count
integer
Total number of responses matching the request.
page
integer
Current page index.
total_pages
integer
Number of available pages.
results_per_page
string
Number of responses returned per page.
data
array
Array of survey response objects.
child attributes
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

Request (cURL) — Basic List
curl -X GET "https://api.alchemer.com/v5/survey/8611799/surveyresponse?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response — Basic List
{
  "result_ok": true,
  "total_count": 89,
  "page": 1,
  "total_pages": 2,
  "results_per_page": "50",
  "data": [
    {
      "id": "1",
      "contact_id": "",
      "status": "Partial",
      "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": null,
          "shown": true
        },
        "4": {
          "id": 4,
          "type": "TEXTBOX",
          "question": "Department",
          "section_id": 1,
          "answer": null,
          "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":"ian.reed@example.com","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": "ian.reed@example.com",
          "shown": true
        },
        "7": {
          "id": 7,
          "type": "ESSAY",
          "question": "Output 3",
          "section_id": 4,
          "answer": null,
          "shown": false
        }
      }
    }
  ]
}
Request (cURL) — Filter by Status
curl -X GET "https://api.alchemer.com/v5/survey/{survey_id}/surveyresponse?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&status EQ partial"
Response — Filter by Status
{
  "result_ok": true,
  "total_count": 17,
  "page": 1,
  "total_pages": 1,
  "results_per_page": "50",
  "data": [
    {
      "id": "1",
      "contact_id": "",
      "status": "Partial",
      "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": null,
          "shown": true
        },
        "4": {
          "id": 4,
          "type": "TEXTBOX",
          "question": "Department",
          "section_id": 1,
          "answer": null,
          "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":"ian.reed@example.com","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": "ian.reed@example.com",
          "shown": true
        },
        "7": {
          "id": 7,
          "type": "ESSAY",
          "question": "Output 3",
          "section_id": 4,
          "answer": null,
          "shown": false
        }
      }
    }
  ]
}
Was this article helpful?
Thank you for your feedback!
© 2020 Alchemer LLC | All rights reserved.