Voice of the Customer

Surveys

The API returns customer's surveys in JSON format

In order to use the API you must have the valid environment-specific username and password. Before any API requests, you need to obtain an API KEY. You will get a valid API KEY by using the VoC authentication API (Please, read how to use API instructions).

The API KEY must be sent in the request authorization header element. If the API KEY value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401). All API requests must be made over HTTPS.

API endpoints

https://voc.bisnode.com/api/responses/prod/v2/company/surveys- production environment
https://voc.bisnode.com/api/responses/test/v2/company/surveys - test environment

API response

Element	Description
surveyId	The survey unique id. Example: 1324. Type: long
name	The customer's name. Type: string
companyID	The customer's ID. Example: 1234. Type: long
surveys	All surveys under the customer. Type: array
surveyName	Name of the survey. Example: "Fall campaign 2017". Type: string
surveyId	The survey unique id. Type: long
created	The date when the survey has been created. Example: 2017-12-03T00:00:00.00Z. Type: date time

API request and response example

curl -X GET "https://voc.bisnode.com/api/responses/test/v2/company/surveys" -H "Authorization: x-api-key ABCDEF1234567890"

Successful API request returns results in JSON format.

{
  "name":"SN4 International Oy",
  "companyID":1,
  "surveys":[
    {
      "surveyName":"VoC SMS Survey Demo",
      "surveyId":3974,
      "created":"2019-02-14T00:21:33.365Z"
    }]
}