---
title: "surveySubmission.list"
method: POST
path: "/surveySubmission.list"
tags: ["Survey Submission"]
---

# surveySubmission.list

`POST /surveySubmission.list`

Lists all survey submissions of a given `surveyType`.

See the [Pagination and Incremental Synchronization](/docs/pagination-and-incremental-sync) guide for detailed usage examples.

**Requires the [`candidatesRead`](authentication#permissions-surveysubmissionlist) permission.**

## Request body

- SurveySubmissionListRequest
  - `surveyType` 'CandidateExperience' | 'Questionnaire' | 'HiringManagerExperience', required — The survey types supported by surveySubmission.list. Supported values: CandidateExperience, Questionnaire, HiringManagerExperience.
  - `cursor` string, nullable — The pagination cursor. Use 'start' for the first page or the nextCursor value from a previous response.
  - `limit` integer, nullable — The maximum number of survey submissions to return per page.
  - `syncToken` string, nullable — A sync token to retrieve only survey submissions updated since the last sync. Obtained from a previous list response.
  - `createdAfter` integer, nullable — Return survey submissions created at or after this date. Unix timestamp in milliseconds.

## Response `200`

Responses from the surveySubmission.list endpoint

- union
  - SurveySubmissionListSuccessResponse
    - `success` true, required
    - `results` SurveySubmissionListResult[], required
      - `id` string, uuid, required — The unique identifier for the survey submission
      - `surveyFormDefinitionId` string, uuid, nullable — The unique identifier for the survey form definition
      - `submittedAt` string, date-time, required — The date and time when the survey was submitted
      - `candidateId` string, uuid, required — The unique identifier for the associated candidate
      - `applicationId` string, uuid, nullable — The unique identifier for the associated application
      - `surveyType` 'CandidateExperience' | 'Questionnaire' | 'HiringManagerExperience', required — The survey types supported by surveySubmission.list. Supported values: CandidateExperience, Questionnaire, HiringManagerExperience.
      - `formDefinition` FormDefinition
        - `sections` FormDefinitionSection[], required — The sections in the form definition
          - `title` string, nullable — The section title
          - `descriptionHtml` string, nullable — The section description formatted as HTML
          - `descriptionPlain` string, nullable — The section description as plain text
          - `fields` FormDefinitionFieldEntry[], required — The fields in this form section
            - `isRequired` boolean, required — Whether this form field is required
            - `descriptionHtml` string, nullable — The field description formatted as HTML
            - `descriptionPlain` string, nullable — The field description as plain text
            - `field` FormDefinitionField, required
              - …
      - `submittedValues` object, nullable — A map of form field paths to submitted values
    - `nextCursor` string — Cursor for the next page of results, if available
    - `moreDataAvailable` boolean — Whether more data is available beyond this page
    - `syncToken` string — Sync token to use for future incremental syncs. Only present on the last page.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)