Skip to main content
Surveys

Get survey responses

Retrieves all user responses for a specific survey.

GET
/v2/surveys/{id}/responses

Query Parameters

  • pageId - Filter responses to a specific survey page
  • limit - Number of items to return (1-100, default 10)
  • cursor - Cursor for pagination

Response Format

Returns a list object with:

  • object - Always "list"
  • data - Array of survey response objects
  • nextCursor - Cursor for next page (null if no more results)

Survey Response Object

Each response includes:

  • id - Unique response identifier
  • user - User who submitted the response (may be null for anonymous)
  • responses - Array of individual answers
  • createdAt - ISO 8601 timestamp when submitted

Individual Response

Each item in the responses array:

  • pageId - The survey page this response is for
  • type - Response type (text, rating, multiple-choice)
  • value - The response value

Errors

  • 404 - Survey not found in your organization

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idstringrequired

Survey unique identifier

Example: 6743752ca81ae59d25cf834b

Query Parameters

pageIdstringquery

Filter by survey page ID

Example: 6743752ca81ae59d25cf834c
limitintegerquerydefault:10

A limit on the number of objects to be returned, between 1 and 100.

Required range: 1 <= x <= 100
Example: 10
cursorstringquery

An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page.

Maximum string length: 512
Example: eyJpZCI6IjY3MTJlMmQxNzU5MDRjZTI0YjJmOTYzNyJ9

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

dataobject[]required

Array of survey responses

nextCursorstring | nullrequired

Cursor for fetching the next page (cursor-based pagination)

objectenum<string>required

Object type identifier

Available options: list
Example: list

Still need help? Ask the team