API V2
API V2
https://api.questionpro.{{env}}/a/api/v2/cx/feedbacks/{{workspaceID}}/surveys
The value of environment {{env}} variable depends upon your datacenter. Refer to the Environment page for more details.
{
"response": [
{
"surveyID": 11111111,
"folderID": 5555555,
"name": "First Survey",
"url": "https://questionpro.com/t/AVcXsZyeE5",
"status": "Active",
"creationDate": "01 Jun, 2023 12:30:00 PM IST",
"modifiedDate": "01 Jun, 2023 06:15:53 PM IST",
"thankYouMessage": "Thank you for completing this survey.",
"responseQuota": 0,
"expiryDate": "",
"inactiveText": "This Survey has been deactivated by the owner.",
"abbs": false,
"saveAndContinue": false,
"surveyFinishMode": 0,
"completedText": "",
"terminatedText": "Your profile does not fit our criteria. Thank you for your time.",
"quotaOverlimitText": "Thank you for your time but we have already received the required responses.",
"cxFeedbackID": 33333,
"hasScoringLogic": false,
"completedResponses": 0,
"viewedResponses": 0,
"startedResponses": 0,
"terminatedResponses": 0,
"lastResponseReceived": "",
"surveyLanguages": [
{
"name": "English",
"contents": null,
"default": true
}
]
}
],
"pagination": {
"perPage": 100,
"totalItems": 1,
"currentPage": 1,
"totalPages": 1,
"links": {
"self": "https://api.questionpro.{{env}}/a/api/v2/cx/feedbacks/{{feedback-id}}/surveys",
"prev": null,
"next": null,
"first": "https://api.questionpro.{{env}}/a/api/v2/cx/feedbacks/{{feedback-id}}/surveys?page=1&perPage=100",
"last": "https://api.questionpro.{{env}}/a/api/v2/cx/feedbacks/{{feedback-id}}/surveys?page=1&perPage=100"
}
},
"requestID": "4012fedc-e8ce-48ae-b800-6q5ce287987a7dje"
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"pagination": {
"type": "object",
"properties": {
"totalItems": {
"type": "integer"
},
"perPage": {
"type": "integer"
},
"totalPages": {
"type": "integer"
},
"links": {
"type": "object",
"properties": {
"next": {
"type": "null"
},
"last": {
"type": "string"
},
"prev": {
"type": "null"
},
"self": {
"type": "string"
},
"first": {
"type": "string"
}
},
"additionalProperties": false,
"required": [
"last",
"self",
"first"
]
},
"currentPage": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"totalItems",
"perPage",
"totalPages",
"links",
"currentPage"
]
},
"response": {
"type": "array",
"items": {
"type": "object",
"properties": {
"viewedResponses": {
"type": "integer"
},
"surveyFinishMode": {
"type": "integer"
},
"inactiveText": {
"type": "string"
},
"startedResponses": {
"type": "integer"
},
"folderID": {
"type": "integer"
},
"expiryDate": {
"type": "string"
},
"terminatedResponses": {
"type": "integer"
},
"responseQuota": {
"type": "integer"
},
"hasScoringLogic": {
"type": "boolean"
},
"saveAndContinue": {
"type": "boolean"
},
"abbs": {
"type": "boolean"
},
"surveyID": {
"type": "integer"
},
"completedText": {
"type": "string"
},
"quotaOverlimitText": {
"type": "string"
},
"thankYouMessage": {
"type": "string"
},
"terminatedText": {
"type": "string"
},
"surveyLanguages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"default": {
"type": "boolean"
},
"contents": {
"type": "null"
},
"name": {
"type": "string"
}
},
"additionalProperties": false,
"required": [
"default",
"name"
]
}
},
"creationDate": {
"type": "string"
},
"url": {
"type": "string"
},
"completedResponses": {
"type": "integer"
},
"cxFeedbackID": {
"type": "integer"
},
"name": {
"type": "string"
},
"modifiedDate": {
"type": "string"
},
"lastResponseReceived": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false,
"required": [
"viewedResponses",
"surveyFinishMode",
"inactiveText",
"startedResponses",
"folderID",
"expiryDate",
"terminatedResponses",
"responseQuota",
"hasScoringLogic",
"saveAndContinue",
"abbs",
"surveyID",
"completedText",
"quotaOverlimitText",
"thankYouMessage",
"terminatedText",
"surveyLanguages",
"creationDate",
"url",
"completedResponses",
"cxFeedbackID",
"name",
"modifiedDate",
"lastResponseReceived",
"status"
]
}
},
"requestID": {
"type": "string"
}
},
"additionalProperties": false,
"required": [
"pagination",
"response",
"requestID"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "BAD_REQUEST",
"httpStatusCode": 400,
"id" : "1000",
"message": "Invalid URL parameters",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "UNAUTHORIZED",
"httpStatusCode": 401,
"id" : "1010",
"message": "Incorrect API Key",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "FORBIDDEN",
"httpStatusCode": 403,
"id" : "1013",
"message": "The user does not have permission to access the resource",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "NOT_FOUND",
"httpStatusCode": 404,
"id" : "1040",
"message": "The resource that you're trying to access doesn't exist",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "INTERNAL_SERVER_ERROR",
"httpStatusCode": 500,
"id" : "1026",
"message": "We are not able to process your request",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}