🚧

This endpoint uses the r_surveys scope, which must be enabled through the Integrations section found within the Settings menu.

Requires a user token whose member has permission to view survey cycles, or an account token together with the member_id query parameter of such a member (the request is then evaluated with that member's permissions). An account token without member_id gets 403 Account tokens need a member_id for this operation. The account must have the Surveys feature enabled.

Only answers of submitted responses are returned, and empty answers are skipped. Members with a scoped role only receive answers of employees within their scope. Deleted survey cycles, and survey cycles outside a scoped member's scope, return 404.

Answers are ordered by participant last name, then first name, then answer id, so paging with limit / offset is stable.

Anonymity

The response shape depends on the survey's is_anonymous setting (see GET /surveys/:id):

• Non-anonymous surveys return each answer together with the participant's identity (employee), the response it belongs to (employee_survey_id) and its submission time (submitted_at).
• Anonymous surveys return the answer content only (id, question_id, question_type, answer, choices). Participant identity, employee_survey_id and submitted_at are never included, so answers cannot be linked to a respondent or to each other.

In addition, when an anonymous survey has min_responses_required greater than 0:

• No answers are returned until at least min_responses_required responses have been submitted.
• Once the threshold is met, answers are returned only for questions that have themselves received at least min_responses_required answers.

Withheld answers are still counted in total_count.

Pagination

limit defaults to 50 (maximum 200) and offset defaults to 0. total_count is the total number of answers matching the filters, regardless of limit / offset.

Use question_ids[] to restrict the answers to specific questions, e.g. ?question_ids[]=2501ee00-0004-51cc-8e1c-6b29548a3d01. Ids that do not belong to the survey's questionnaire are ignored; if none match, an empty result is returned.

Results

Non-anonymous survey:

{
  "total_count": 3,
  "answers": [
    {
      "id": "1b3f",
      "employee_survey_id": "9c2",
      "question_id": "2501ee00-0003-51cc-8e1c-6b29548a3d01",
      "question_type": "paragraph",
      "answer": "<p>Solving customer problems with the team.</p>",
      "choices": null,
      "submitted_at": "2025-03-02T10:05:00.000Z",
      "employee": {
        "id": "5e7",
        "name": "Doe, Jane"
      }
    },
    {
      "id": "1b40",
      "employee_survey_id": "9c2",
      "question_id": "2501ee00-0004-51cc-8e1c-6b29548a3d01",
      "question_type": "multiple_choice",
      "answer": null,
      "choices": [
        "1"
      ],
      "submitted_at": "2025-03-02T10:05:00.000Z",
      "employee": {
        "id": "5e7",
        "name": "Doe, Jane"
      }
    },
    {
      "id": "1b3a",
      "employee_survey_id": "9c5",
      "question_id": "2501ee00-0004-51cc-8e1c-6b29548a3d01",
      "question_type": "multiple_choice",
      "answer": null,
      "choices": [
        "2"
      ],
      "submitted_at": "2025-03-05T12:00:00.000Z",
      "employee": {
        "id": "5f1",
        "name": "Smith, Alex"
      }
    }
  ]
}

Anonymous survey:

{
  "total_count": 2,
  "answers": [
    {
      "id": "1b3f",
      "question_id": "2501ee00-0003-51cc-8e1c-6b29548a3d01",
      "question_type": "paragraph",
      "answer": "<p>Solving customer problems with the team.</p>",
      "choices": null
    },
    {
      "id": "1b40",
      "question_id": "2501ee00-0004-51cc-8e1c-6b29548a3d01",
      "question_type": "multiple_choice",
      "answer": null,
      "choices": [
        "1"
      ]
    }
  ]
}

Error responses

Error bodies: 401 / 403 responses are plain text holding the reason (e.g. Required scopes missing: ["r_surveys"]). 404 responses are JSON of the form {"message": "..."}. 400 validation errors are JSON keyed by the offending field, e.g. {"limit": {"code": "number.min", "message": "\"limit\" must be greater than or equal to 1"}}.