Surveys

Merchant REST API endpoints related to Okendo Surveys

List Survey Responses

get

Returns a list of Survey Responses for the requested survey

Authorizations

basic

AuthorizationstringRequired

Path parameters

surveyIdstring · uuidRequired

The ID of the survey to retrieve responses for

Query parameters

limitinteger · int32Optional

A limit on the number of items returned. Between 1 and 100. Default 25.

Example: 25

lastEvaluatedstringOptional

The URL-encoded JSON object representing the cursor for the next page of results.

orderBystringOptional

The sort order of the survey responses. Format: '(date) (asc|desc)'. Default 'date desc'

Example: date desc

Responses

200

An object containing a list of Survey Responses and a relative link to the next page of results if available.

application/json

400

Invalid request parameters.

application/json

401

Authentication credentials are missing or incorrect.

404

The requested resource could not be found.

application/json

get

/surveys/{surveyId}/responses

HTTPcURLJavaScriptPython

GET /enterprise/surveys/{surveyId}/responses HTTP/1.1
Host: api.okendo.io
Authorization: Basic username:password
Accept: */*

{
  "surveyResponses": [
    {
      "subscriberId": "123e4567-e89b-12d3-a456-426614174000",
      "surveyResponseId": "123e4567-e89b-12d3-a456-426614174000",
      "surveyId": "123e4567-e89b-12d3-a456-426614174000",
      "surveyName": "text",
      "channelSurveyId": "123e4567-e89b-12d3-a456-426614174000",
      "channelSurveyDescription": "text",
      "channel": "on-site",
      "answeredQuestions": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "text": "text",
          "type": "text",
          "answer": "text"
        }
      ],
      "customer": {
        "customerId": "123e4567-e89b-12d3-a456-426614174000",
        "email": "[email protected]"
      },
      "dateCreated": "2026-02-02T14:50:39.658Z",
      "emailMarketingOptIn": true,
      "isArchived": true,
      "order": {
        "remoteOrderId": "text"
      },
      "reward": {
        "type": "coupon",
        "description": "text",
        "value": "text"
      }
    }
  ],
  "nextUrl": "https://example.com"
}