## Get survey responses

**get** `/v2/surveys/{id}/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

### Path Parameters

- `id: string`

  Survey unique identifier

### Query Parameters

- `cursor: optional string`

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

- `limit: optional number`

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

- `pageId: optional string`

  Filter by survey page ID

### Header Parameters

- `"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"`

  - `"2026-01-01.nova"`

  - `"2025-12-12.clover"`

### Returns

- `data: array of object { id, createdAt, object, 2 more }`

  Array of survey responses

  - `id: string`

    Unique identifier

  - `createdAt: string`

    ISO 8601 timestamp when created

  - `object: "survey_response"`

    Object type identifier

    - `"survey_response"`

  - `responses: array of object { pageId, type, value, 3 more }`

    Individual responses to questions

    - `pageId: string`

      Page ID this response is for

    - `type: "text" or "link" or "rating" or "multiple-choice"`

      Response type

      - `"text"`

      - `"link"`

      - `"rating"`

      - `"multiple-choice"`

    - `value: string or number or boolean or array of string`

      Response value

      - `string`

      - `number`

      - `boolean`

      - `array of string`

    - `id: optional string`

      Response ID

    - `createdAt: optional string`

      ISO 8601 timestamp when created

    - `updatedAt: optional string`

      ISO 8601 timestamp when updated

  - `user: Contact`

    User who submitted the response

    - `id: string`

      Unique identifier

    - `name: string`

      Contact display name

    - `object: "contact"`

      Object type identifier

      - `"contact"`

    - `type: "customer" or "lead"`

      Type of contact

      - `"customer"`

      - `"lead"`

    - `commentsCreated: optional number`

      Number of comments created

    - `companies: optional array of Company`

      Companies the contact belongs to

      - `id: string`

        Featurebase internal ID

      - `companyId: string`

        External company ID from your system

      - `companySize: number`

        Company employee headcount

      - `createdAt: string`

        ISO date when company was created

      - `industry: string`

        Industry

      - `lastActivity: string`

        ISO date of last activity

      - `linkedUsers: number`

        Number of users linked to this company

      - `monthlySpend: number`

        Monthly spend

      - `name: string`

        Company name

      - `object: "company"`

        Object type identifier

        - `"company"`

      - `plan: string`

        Plan or tier name

      - `updatedAt: string`

        ISO date when company was last updated

      - `website: string`

        Company website URL

      - `customFields: optional map[unknown]`

        Custom field values

    - `customFields: optional map[unknown]`

      Custom field values on the contact

    - `description: optional string`

      Contact description/bio

    - `email: optional string`

      Contact email

    - `lastActivity: optional string`

      Last activity ISO timestamp

    - `locale: optional string`

      Contact locale

    - `manuallyOptedOutFromChangelog: optional boolean`

      Whether manually opted out from changelog

    - `organizationId: optional string`

      Organization ID the contact belongs to

    - `postsCreated: optional number`

      Number of posts created

    - `profilePicture: optional string`

      Profile picture URL

    - `roles: optional array of string`

      Contact roles

    - `subscribedToChangelog: optional boolean`

      Whether subscribed to changelog

    - `userId: optional string`

      External user ID from SSO

    - `verified: optional boolean`

      Whether email is verified

- `nextCursor: string`

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

- `object: "list"`

  Object type identifier

  - `"list"`

### Example

```http
curl https://do.featurebase.app/v2/surveys/$ID/responses \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY"
```

#### Response

```json
{
  "data": [
    {
      "id": "6712e2d175904ce24b2f9637",
      "createdAt": "2024-10-18T22:36:01.269Z",
      "object": "survey_response",
      "responses": [
        {
          "pageId": "66dc53c5a64824f0e84a4c1e",
          "type": "multiple-choice",
          "value": [
            "66dc54128b989696d050008b"
          ],
          "id": "6712e2d175904ce24b2f9638",
          "createdAt": "2024-10-18T22:36:01.270Z",
          "updatedAt": "2024-10-18T22:36:01.270Z"
        }
      ],
      "user": {
        "id": "676f0f6765bdaa7d7d760f88",
        "name": "John Steezy",
        "object": "contact",
        "type": "customer",
        "commentsCreated": 0,
        "companies": [
          {
            "id": "507f1f77bcf86cd799439011",
            "companyId": "comp_12345",
            "companySize": 250,
            "createdAt": "2025-01-01T12:00:00.000Z",
            "industry": "Technology",
            "lastActivity": "2025-01-15T00:00:00.000Z",
            "linkedUsers": 15,
            "monthlySpend": 5000,
            "name": "Acme Inc",
            "object": "company",
            "plan": "enterprise",
            "updatedAt": "2025-01-10T15:30:00.000Z",
            "website": "https://acme.com",
            "customFields": {
              "location": "bar",
              "priority": "bar"
            }
          }
        ],
        "customFields": {
          "foo": "bar"
        },
        "description": "",
        "email": "john@example.com",
        "lastActivity": "2025-01-03T21:42:30.181Z",
        "locale": "en",
        "manuallyOptedOutFromChangelog": false,
        "organizationId": "5febde12dc56d60012d47db6",
        "postsCreated": 0,
        "profilePicture": "https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/anon_23.png",
        "roles": [
          "string"
        ],
        "subscribedToChangelog": true,
        "userId": "676f0f673dbb299c8a4f3057",
        "verified": true
      }
    }
  ],
  "nextCursor": null,
  "object": "list"
}
```