List Surveys
Returns a paginated list of all surveys in the authenticated account.
Endpoint
GET
v5/survey
Requires authentication
Path Parameters
None
Query Parameters
None
Response
Returns a paginated array of survey objects belonging to the authenticated account.
result_ok
boolean
Whether the request succeeded.
total_count
integer
Total number of surveys in the account.
page
integer
Current page index of the result set.
total_pages
integer
Total number of available result pages.
results_per_page
integer
Number of results returned per page.
data
array
Array of survey objects.
child attributes
id
string
The unique ID of the survey.
team
string
The ID of the team that owns the survey.
type
string
The survey type. Example values:
Standard Survey, QuestionLibrary.status
string
The current status of the survey. Example values:
Launched, Closed.created_on
string
Timestamp when the survey was created.
modified_on
string
Timestamp when the survey was last modified.
title
string
The title of the survey.
statistics
object | null
Response count totals keyed by status. Returns
null for survey types that do not collect responses (e.g. QuestionLibrary).child attributes
Complete
integer
Number of completed responses. Only present if the count is greater than zero.
Partial
integer
Number of partial responses. Only present if the count is greater than zero.
Deleted
integer
Number of deleted responses. Only present if the count is greater than zero.
Disqualified
integer
Number of disqualified responses. Only present if the count is greater than zero.
links
object
Direct URLs for common actions on the survey.
child attributes
edit
string
URL to open the survey in the Alchemer editor.
publish
string
URL to open the survey's distribution settings.
default
string
The default public URL for the survey.
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?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"total_count": 3,
"page": 1,
"total_pages": 1,
"results_per_page": 3,
"data": [
{
"id": "YOUR_SURVEY_ID",
"team": "YOUR_TEAM_ID",
"type": "Standard Survey",
"status": "Launched",
"created_on": "2026-03-19 15:58:55",
"modified_on": "2026-03-19 16:00:31",
"title": "Q1 Customer Feedback",
"statistics": {
"Complete": 5
},
"links": {
"edit": "https://app.alchemer.com/projects/editor?id=YOUR_SURVEY_ID",
"publish": "https://app.alchemer.com/distribute/share?id=YOUR_SURVEY_ID",
"default": "https://survey.alchemer.com/s3/YOUR_SURVEY_ID/q1-customer-feedback"
}
},
{
"id": "YOUR_SURVEY_ID_2",
"team": "YOUR_TEAM_ID",
"type": "Standard Survey",
"status": "Launched",
"created_on": "2025-12-09 16:50:42",
"modified_on": "2026-03-26 15:46:58",
"title": "Annual Employee Survey",
"statistics": {
"Partial": 52,
"Deleted": 1,
"Complete": 41
},
"links": {
"edit": "https://app.alchemer.com/projects/editor?id=YOUR_SURVEY_ID_2",
"publish": "https://app.alchemer.com/distribute/share?id=YOUR_SURVEY_ID_2",
"default": "https://survey.alchemer.com/s3/YOUR_SURVEY_ID_2/annual-employee-survey"
}
},
{
"id": "YOUR_SURVEY_ID_3",
"team": "YOUR_TEAM_ID",
"type": "QuestionLibrary",
"status": "Launched",
"created_on": "2025-10-21 17:13:35",
"modified_on": "2025-10-21 17:13:36",
"title": "My Question Library",
"statistics": null,
"links": {
"edit": "https://app.alchemer.com/projects/editor?id=YOUR_SURVEY_ID_3",
"publish": "https://app.alchemer.com/distribute/share?id=YOUR_SURVEY_ID_3",
"default": "https://survey.alchemer.com/s3/YOUR_SURVEY_ID_3/my-question-library"
}
}
]
}