# Get survey responses

Retrieves all user responses for a specific survey.

### 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

Endpoint: GET /v2/surveys/{id}/responses
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Path parameters:

  - `id` (string, required)
    Survey unique identifier
    Example: "6743752ca81ae59d25cf834b"

## Query parameters:

  - `pageId` (string)
    Filter by survey page ID
    Example: "6743752ca81ae59d25cf834c"

  - `limit` (integer)
    A limit on the number of objects to be returned, between 1 and 100.
    Example: 10

  - `cursor` (string)
    An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page.
    Example: "eyJpZCI6IjY3MTJlMmQxNzU5MDRjZTI0YjJmOTYzNyJ9"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "list"

  - `data` (array, required)
    Array of survey responses
    Example: []

  - `data.id` (string, required)
    Unique identifier
    Example: "6712e2d175904ce24b2f9637"

  - `data.user` (object,null, required)
    User who submitted the response

  - `data.user.userId` (string)
    External user ID from SSO
    Example: "676f0f673dbb299c8a4f3057"

  - `data.user.organizationId` (string)
    Organization ID the contact belongs to
    Example: "5febde12dc56d60012d47db6"

  - `data.user.companies` (array)
    Companies the contact belongs to
    Example: []

  - `data.user.companies.id` (string, required)
    Featurebase internal ID
    Example: "507f1f77bcf86cd799439011"

  - `data.user.companies.companyId` (string, required)
    External company ID from your system
    Example: "comp_12345"

  - `data.user.companies.name` (string, required)
    Company name
    Example: "Acme Inc"

  - `data.user.companies.monthlySpend` (number,null, required)
    Monthly spend
    Example: 5000

  - `data.user.companies.industry` (string,null, required)
    Industry
    Example: "Technology"

  - `data.user.companies.website` (string,null, required)
    Company website URL
    Example: "https://acme.com"

  - `data.user.companies.plan` (string,null, required)
    Plan or tier name
    Example: "enterprise"

  - `data.user.companies.linkedUsers` (number,null, required)
    Number of users linked to this company
    Example: 15

  - `data.user.companies.companySize` (number,null, required)
    Company employee headcount
    Example: 250

  - `data.user.companies.lastActivity` (string,null, required)
    ISO date of last activity
    Example: "2025-01-15T00:00:00.000Z"

  - `data.user.companies.customFields` (object)
    Custom field values
    Example: {"location":"Europe","priority":"high"}

  - `data.user.companies.createdAt` (string,null, required)
    ISO date when company was created
    Example: "2025-01-01T12:00:00.000Z"

  - `data.user.companies.updatedAt` (string,null, required)
    ISO date when company was last updated
    Example: "2025-01-10T15:30:00.000Z"

  - `data.user.email` (string,null)
    Contact email
    Example: "john@example.com"

  - `data.user.name` (string, required)
    Contact display name
    Example: "John Steezy"

  - `data.user.profilePicture` (string,null)
    Profile picture URL
    Example: "https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/anon_23.png"

  - `data.user.commentsCreated` (number)
    Number of comments created

  - `data.user.postsCreated` (number)
    Number of posts created

  - `data.user.lastActivity` (string)
    Last activity ISO timestamp
    Example: "2025-01-03T21:42:30.181Z"

  - `data.user.subscribedToChangelog` (boolean)
    Whether subscribed to changelog
    Example: true

  - `data.user.manuallyOptedOutFromChangelog` (boolean)
    Whether manually opted out from changelog

  - `data.user.roles` (array)
    Contact roles
    Example: []

  - `data.user.locale` (string)
    Contact locale
    Example: "en"

  - `data.user.verified` (boolean)
    Whether email is verified
    Example: true

  - `data.user.type` (string, required)
    Type of contact
    Enum: "customer", "lead"

  - `data.user.description` (string)
    Contact description/bio

  - `data.user.customFields` (object)
    Custom field values on the contact

  - `data.responses` (array, required)
    Individual responses to questions
    Example: []

  - `data.responses.pageId` (string, required)
    Page ID this response is for
    Example: "66dc53c5a64824f0e84a4c1e"

  - `data.responses.type` (string, required)
    Response type
    Enum: "text", "link", "rating", "multiple-choice"

  - `data.responses.value` (any, required)
    Response value
    Example: ["66dc54128b989696d050008b"]

  - `data.responses.id` (string)
    Response ID
    Example: "6712e2d175904ce24b2f9638"

  - `data.responses.createdAt` (string)
    ISO 8601 timestamp when created
    Example: "2024-10-18T22:36:01.270Z"

  - `data.responses.updatedAt` (string)
    ISO 8601 timestamp when updated
    Example: "2024-10-18T22:36:01.270Z"

  - `nextCursor` (string,null, required)
    Cursor for fetching the next page (cursor-based pagination)

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id", "invalid_cursor"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "survey_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404