API V2
API V2
QuestionPro APIs will always return the data in English language, if you're dealing with multilingual surveys then please use the following API call to fetch the translations setup for your QuestionPro survey:
Please refer to the following example of a Get Survey response body for a multilingual survey:
{
"response": {
"surveyID": 9876543,
"folderID": 9000003,
"name": "Multilingual API Test Survey",
"url": "https://www.questionpro.com/t/XXXXXXXXXX",
"status": "Active",
"creationDate": "07 Dec, 2020 12:00:00 AM PST",
"modifiedDate": "07 Dec, 2020 06:20:33 AM PST",
"thankYouMessage": "Thank you for completing this survey.",
"responseQuota": 0,
"expiryDate": "",
"inactiveText": "This Survey has been deactivated by the owner.",
"abbs": false,
"saveAndContinue": false,
"surveyFinishMode": 15,
"completedText": "<div style=\"text-align: center;\">Thank you for completing this survey.</div>",
"terminatedText": "<div style=\"text-align: center;\">Your profile does not fit our criteria. Thank you for your time</div>",
"quotaOverlimitText": "<div style=\"text-align: center;\">Thank you for your time but we have already received the required responses.</div>",
"hasScoringLogic": false,
"logoUrl": "https://www.questionpro.com/qp_userimages/sub-3/1234567/qpcube_10.png",
"completedResponses": 3,
"surveyLanguages": [
{
"name": "French",
"contents": [
{
"type": "TYPE_ANSWER",
"content": " Très satisfait",
"id": 303000025
},
{
"type": "TYPE_ANSWER",
"content": " Satisfait",
"id": 303000024
},
{
"type": "TYPE_ANSWER",
"content": " Neutre",
"id": 303000023
},
{
"type": "TYPE_ANSWER",
"content": " Insatisfait",
"id": 303000022
},
{
"type": "TYPE_ANSWER",
"content": " Très insatisfait",
"id": 303000021
},
{
"type": "TYPE_QUESTION",
"content": " Êtes-vous satisfait de nos services?",
"id": 20000002
},
{
"type": "TYPE_ANSWER",
"content": " Toujours ",
"id": 302000005
},
{
"type": "TYPE_ANSWER",
"content": " Le plus souvent",
"id": 302000004
},
{
"type": "TYPE_ANSWER",
"content": " Environ la moitié du temps",
"id": 302000003
},
{
"type": "TYPE_ANSWER",
"content": " De temps à autre",
"id": 302000002
},
{
"type": "TYPE_ANSWER",
"content": " Jamais",
"id": 302000001
},
{
"type": "TYPE_QUESTION",
"content": " À quelle fréquence menez-vous des sondages?",
"id": 20000001
},
{
"type": "UNKNOWN",
"content": " Le propriétaire de cette enquête a empêché les utilisateurs de participer plusieurs fois à l'enquête. Puisque nous avons déjà une réponse de votre part, nous ne pouvons pas accepter votre réponse pour le moment."
},
{
"type": "TYPE_SEO_SURVEY_DESCRIPTION",
"content": " Enquête de test API multilingue"
},
{
"type": "TYPE_SAVE_AND_CONTINUE_HREF_TEXT",
"content": " Commencer l'enquête enregistrée"
},
{
"type": "TYPE_SAVE_AND_CONTINUE_EMAIL_TEXT",
"content": " Bonjour, Nous avons une réponse partielle enregistrée pour vous. Pour démarrer l'enquête à partir de l'endroit où vous l'avez sauvegardé, veuillez cliquer sur le lien ci-dessous:<SAVED_SURVEY_LINK> Merci."
},
{
"type": "TYPE_SAVE_AND_CONTINUE_EMAIL_SUBJECT",
"content": " Votre enquête enregistrée"
},
{
"type": "TYPE_SURVEY_AUTH_INVALID_KEY_TEXT",
"content": " Clé non valide"
},
{
"type": "TYPE_SURVEY_AUTH_UNIQUE_KEY_TEXT",
"content": " Clé unique"
},
{
"type": "TYPE_SURVEY_AUTH_INVALID_USERNAME_PASSWORD_TEXT",
"content": " Nom d'utilisateur ou mot de passe invalide"
},
{
"type": "TYPE_SURVEY_AUTH_USERNAME_PASSWORD_TEXT",
"content": " Mot de passe"
},
{
"type": "TYPE_SURVEY_AUTH_USERNAME_TEXT",
"content": " Nom d'utilisateur"
},
{
"type": "TYPE_SURVEY_AUTH_INVALID_EMAIL_PASSWORD_TEXT",
"content": " Adresse e-mail ou mot de passe invalide"
},
{
"type": "TYPE_SURVEY_AUTH_EMAIL_PASSWORD_TEXT",
"content": " Mot de passe"
},
{
"type": "TYPE_SURVEY_AUTH_EMAIL_ADDRESS_TEXT",
"content": " Adresse e-mail"
},
{
"type": "TYPE_NAME",
"content": " Enquête de test API multilingue"
},
{
"type": "TYPE_INACTIVE_TEXT",
"content": " Cette enquête a été désactivée par le propriétaire."
},
{
"type": "TYPE_VALIDATION_MESSAGE",
"content": " Les questions marquées d'un * sont obligatoires"
},
{
"type": "TYPE_SAVE_AND_CONT_BUTTON",
"content": " Enregistrer et continuer plus tard"
},
{
"type": "UNKNOWN",
"content": " Quitter l'enquête"
},
{
"type": "TYPE_FINISH_URL_TEXT",
"content": " Merci d'avoir complété ce sondage."
},
{
"type": "TYPE_FINISH",
"content": "<div style=\"text-align: center;\"> Merci d'avoir complété ce sondage.</div>"
},
{
"type": "TYPE_FINISH_BUTTON",
"content": " Terminé"
},
{
"type": "TYPE_CONTINUE_BUTTON",
"content": " Prochain"
},
{
"type": "TYPE_HEADER",
"content": " Enquête de test API multilingue"
},
{
"type": "UNKNOWN",
"content": "<img src=\"/images/image-not-uploaded.png\" />"
}
],
"default": false
},
{
"name": "German",
"contents": [
{
"type": "TYPE_ANSWER",
"content": " sehr zufrieden",
"id": 303000025
},
{
"type": "TYPE_ANSWER",
"content": " Zufrieden",
"id": 303000024
},
{
"type": "TYPE_ANSWER",
"content": " Neutral",
"id": 303000023
},
{
"type": "TYPE_ANSWER",
"content": " Nicht zufrieden",
"id": 303000022
},
{
"type": "TYPE_ANSWER",
"content": " sehr unbefriedigt",
"id": 303000021
},
{
"type": "TYPE_QUESTION",
"content": " Wie zufrieden sind Sie mit unseren Dienstleistungen?",
"id": 20000002
},
{
"type": "TYPE_ANSWER",
"content": " Immer ",
"id": 302000005
},
{
"type": "TYPE_ANSWER",
"content": " Meistens",
"id": 302000004
},
{
"type": "TYPE_ANSWER",
"content": " Etwa die Hälfte der Zeit",
"id": 302000003
},
{
"type": "TYPE_ANSWER",
"content": " Abundzu",
"id": 302000002
},
{
"type": "TYPE_ANSWER",
"content": " noch nie",
"id": 302000001
},
{
"type": "TYPE_QUESTION",
"content": " Wie oft führen Sie Umfragen durch?",
"id": 20000001
},
{
"type": "UNKNOWN",
"content": " Der Eigentümer dieser Umfrage hat Benutzer daran gehindert, mehrmals an der Umfrage teilzunehmen. Da wir bereits eine Antwort von Ihnen haben, können wir Ihre Antwort derzeit nicht akzeptieren."
},
{
"type": "TYPE_SEO_SURVEY_DESCRIPTION",
"content": " Mehrsprachige API-Testumfrage"
},
{
"type": "TYPE_SAVE_AND_CONTINUE_HREF_TEXT",
"content": " Gespeicherte Umfrage starten"
},
{
"type": "TYPE_SAVE_AND_CONTINUE_EMAIL_TEXT",
"content": " Hallo, wir haben eine Teilantwort für Sie gespeichert. Um die Umfrage dort zu starten, wo Sie sie gespeichert haben, klicken Sie bitte auf den folgenden Link:<SAVED_SURVEY_LINK> Danke."
},
{
"type": "TYPE_SAVE_AND_CONTINUE_EMAIL_SUBJECT",
"content": " Ihre gespeicherte Umfrage"
},
{
"type": "TYPE_SURVEY_AUTH_INVALID_KEY_TEXT",
"content": " Ungültiger Schlüssel"
},
{
"type": "TYPE_SURVEY_AUTH_UNIQUE_KEY_TEXT",
"content": " Einzigartiger Schlüssel"
},
{
"type": "TYPE_SURVEY_AUTH_INVALID_USERNAME_PASSWORD_TEXT",
"content": " Ungültiger Benutzername oder Passwort"
},
{
"type": "TYPE_SURVEY_AUTH_USERNAME_PASSWORD_TEXT",
"content": " Passwort"
},
{
"type": "TYPE_SURVEY_AUTH_USERNAME_TEXT",
"content": " Nutzername"
},
{
"type": "TYPE_SURVEY_AUTH_INVALID_EMAIL_PASSWORD_TEXT",
"content": " Ungültige Emailadresse oder Passwort"
},
{
"type": "TYPE_SURVEY_AUTH_EMAIL_PASSWORD_TEXT",
"content": " Passwort"
},
{
"type": "TYPE_SURVEY_AUTH_EMAIL_ADDRESS_TEXT",
"content": " E-Mail-Addresse"
},
{
"type": "TYPE_NAME",
"content": " Mehrsprachige API-Testumfrage"
},
{
"type": "TYPE_INACTIVE_TEXT",
"content": " Diese Umfrage wurde vom Eigentümer deaktiviert."
},
{
"type": "TYPE_VALIDATION_MESSAGE",
"content": " Mit einem * gekennzeichnete Fragen sind erforderlich"
},
{
"type": "TYPE_SAVE_AND_CONT_BUTTON",
"content": " Speichern und später fortfahren"
},
{
"type": "UNKNOWN",
"content": " Umfrage beenden"
},
{
"type": "TYPE_FINISH_URL_TEXT",
"content": " Vielen Dank für das Ausfüllen dieser Umfrage."
},
{
"type": "TYPE_FINISH",
"content": "<div style=\"text-align: center;\"> Vielen Dank für das Ausfüllen dieser Umfrage.</div>"
},
{
"type": "TYPE_FINISH_BUTTON",
"content": " Erledigt"
},
{
"type": "TYPE_CONTINUE_BUTTON",
"content": " Nächster"
},
{
"type": "TYPE_HEADER",
"content": " Mehrsprachige API-Testumfrage"
},
{
"type": "UNKNOWN",
"content": "<img src=\"/images/image-not-uploaded.png\" />"
}
],
"default": false
},
{
"name": "English",
"contents": null,
"default": true
}
]
}
}
As mentioned above, the language for the response of the API calls is always English but we do provide a parameter named "language" in the responses API call to get the language in which the respondent has answered the survey. Please refer to the following example for the same:
{
"response": [
{
"responseID": 12345679,
"surveyID": 9876543,
"surveyName": "Multilingual API Test Survey",
"ipAddress": "192.68.0.1",
"timestamp": "07 Dec, 2020 05:33:22 AM PST",
"location": {
"country": null,
"region": "16",
"latitude": 35.321564789954,
"longitude": 24.654987321568,
"radius": 0.0,
"countryCode": "IN"
},
"duplicate": false,
"timeTaken": 3,
"responseStatus": "Completed",
"externalReference": "",
"customVariables": {
"custom1": null,
"custom2": null,
"custom3": null,
"custom4": null,
"custom5": null
},
"language": "German",
"currentInset": "",
"operatingSystem": "WINDOWS_10",
"osDeviceType": "COMPUTER",
"browser": "CHROME8",
"responseSet": [
{
"questionID": 20000001,
"questionDescription": " ",
"questionCode": "Q1",
"questionText": "How often do you conduct surveys?",
"imageUrl": null,
"answerValues": [
{
"answerID": 302000002,
"answerText": "Once in a while",
"value": {
"scale": "2",
"other": "",
"dynamicExplodeText": "",
"text": "",
"result": "",
"fileLink": "",
"weight": 0.0
}
}
]
},
{
"questionID": 20000002,
"questionDescription": " ",
"questionCode": "Q2",
"questionText": "How satisfied are you with our services",
"imageUrl": null,
"answerValues": [
{
"answerID": 303000022,
"answerText": "Unsatisfied",
"value": {
"scale": "2",
"other": "",
"dynamicExplodeText": "",
"text": "",
"result": "",
"fileLink": "",
"weight": 0.0
}
}
]
}
],
"utctimestamp": 22
},
{
"responseID": 12345678,
"surveyID": 9876543,
"surveyName": "Multilingual API Test Survey",
"ipAddress": "192.68.0.11",
"timestamp": "07 Dec, 2020 05:33:13 AM PST",
"location": {
"country": null,
"region": "16",
"latitude": 33.500000147461,
"longitude": 94.530890000052,
"radius": 0.0,
"countryCode": "IN"
},
"duplicate": false,
"timeTaken": 5,
"responseStatus": "Completed",
"externalReference": "",
"customVariables": {
"custom1": null,
"custom2": null,
"custom3": null,
"custom4": null,
"custom5": null
},
"language": "French",
"currentInset": "",
"operatingSystem": "WINDOWS_10",
"osDeviceType": "COMPUTER",
"browser": "CHROME8",
"responseSet": [
{
"questionID": 20000001,
"questionDescription": " ",
"questionCode": "Q1",
"questionText": "How often do you conduct surveys?",
"imageUrl": null,
"answerValues": [
{
"answerID": 302000004,
"answerText": "Most of the time",
"value": {
"scale": "4",
"other": "",
"dynamicExplodeText": "",
"text": "",
"result": "",
"fileLink": "",
"weight": 0.0
}
}
]
},
{
"questionID": 20000002,
"questionDescription": " ",
"questionCode": "Q2",
"questionText": "How satisfied are you with our services",
"imageUrl": null,
"answerValues": [
{
"answerID": 303000023,
"answerText": "Neutral",
"value": {
"scale": "3",
"other": "",
"dynamicExplodeText": "",
"text": "",
"result": "",
"fileLink": "",
"weight": 0.0
}
}
]
}
],
"utctimestamp": 13
},
{
"responseID": 12345677,
"surveyID": 9876543,
"surveyName": "Multilingual API Test Survey",
"ipAddress": "192.68.0.21",
"timestamp": "07 Dec, 2020 05:33:03 AM PST",
"location": {
"country": null,
"region": "16",
"latitude": 36.50000007401,
"longitude": 44.530000000852,
"radius": 0.0,
"countryCode": "IN"
},
"duplicate": false,
"timeTaken": 5,
"responseStatus": "Completed",
"externalReference": "",
"customVariables": {
"custom1": null,
"custom2": null,
"custom3": null,
"custom4": null,
"custom5": null
},
"language": "English",
"currentInset": "",
"operatingSystem": "WINDOWS_10",
"osDeviceType": "COMPUTER",
"browser": "CHROME8",
"responseSet": [
{
"questionID": 20000001,
"questionDescription": " ",
"questionCode": "Q1",
"questionText": "How often do you conduct surveys?",
"imageUrl": null,
"answerValues": [
{
"answerID": 302000003,
"answerText": "About half the time",
"value": {
"scale": "3",
"other": "",
"dynamicExplodeText": "",
"text": "",
"result": "",
"fileLink": "",
"weight": 0.0
}
}
]
},
{
"questionID": 20000002,
"questionDescription": " ",
"questionCode": "Q2",
"questionText": "How satisfied are you with our services",
"imageUrl": null,
"answerValues": [
{
"answerID": 303000024,
"answerText": "Satisfied",
"value": {
"scale": "4",
"other": "",
"dynamicExplodeText": "",
"text": "",
"result": "",
"fileLink": "",
"weight": 0.0
}
}
]
}
],
"utctimestamp": 3
}
],
"pagination": {
"perPage": 100,
"totalItems": 3,
"currentPage": 1,
"totalPages": 1,
"links": {
"self": "https://{{env}}.questionpro.com/a/api/v2/surveys/{{survey-id}}/responses?page=1&perPage=100&apiKey={{apiKey}}",
"prev": null,
"next": null,
"first": "https://{{env}}.questionpro.com/a/api/v2/surveys/{{survey-id}}/responses?page=1&perPage=100&apiKey={{apiKey}}",
"last": "https://{{env}}.questionpro.com/a/api/v2/surveys/{{survey-id}}/responses?page=1&perPage=100&apiKey={{apiKey}}"
}
}
}
Please refer to the following link to check the supported languages: