Survey Object

The following API calls are currently available for the Survey object:

For info on returned fields and example returns go to Survey Object Returned Fields.

GET LIST - Get a list of all of your surveys. View Example Return.

https://api.alchemer.com/v4/survey
ParametersExampleRequired
Authentication Credentialsapi_token=abcd12345&api_token_secret=abcd12345
True
pagepage=3False
resultsperpageresultsperpage=100False
filtersfilter[field][0]=subtype&filter[operator][1]==&filter[value][1]=surveyFalse

GET SURVEY - Get information about a specified survey. View Example Return.

https://api.alchemer.com/v4/survey/123456
ParametersExampleRequired
Authentication Credentialsapi_token=abcd12345&api_token_secret=abcd12345
True
metaonly (exclude page info)falseFalse

CREATE SURVEY - Create a new survey. View Example Return.

https://api.alchemer.com/v4/survey/?_method=PUT&title=Title&type=survey
ParametersExampleRequired
Authentication Credentialsapi_token=abcd12345&api_token_secret=abcd12345
True
titleMy New SurveyTrue
typesurvey, form, poll, quizTrue
statuslaunched, closed, deletedFalse
theme*11147False
team456789False
options[internal_title]Internal TitleFalse
blockbyNONE, IP, COOKIEFalse
Poll-Specific ParametersExampleRequired
polloptionspolloptions[0]=option 1&polloptions[1]=option 2True
polltyperadio, image, rankingFalse
pollwidth140, 300, 600False

*The theme parameter only supports saved themes in your Theme Library. To obtain the ID, go to Account > Libraries > Survey Themes and select the theme you wish to use. The ID will display in the URL.

UPDATE/COPY SURVEY - Update and/or copy a specified survey. View Example Return.

https://api.alchemer.com/v4/survey/123456?_method=POST
Poll-Specific ParametersExampleRequired
ParametersExampleRequired
Authentication Credentialsapi_token=abcd12345&api_token_secret=abcd12345
True
titleMy New SurveyFalse
statuslaunched, closed, deletedFalse
theme*11147False
team456789False
options[internal_title]Internal TitleFalse
blockbyNONE, IP, COOKIEFalse
copytrueFalse
polloptionspolloptions[0]=option 1&polloptions[1]=option 2False
polltyperadio, image, rankingFalse

*The theme parameter only supports saved themes in your Theme Library. To obtain the ID, go to Account > Libraries > Survey Themes and select the theme you wish to use. The ID will display in the URL.

DELETE SURVEY - Delete a specified survey. View Example Return.

https://api.alchemer.com/v4/survey/123456?_method=DELETE
ParametersExampleRequired
Authentication Credentialsapi_token=abcd12345&api_token_secret=abcd12345
True

Back to the Top