---
title: "List survey responses"
method: GET
path: "/3.0/reporting/surveys/{survey_id}/responses"
tags: ["reporting"]
---

# List survey responses

`GET /3.0/reporting/surveys/{survey_id}/responses`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/reporting/surveys/{survey_id}/responses`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/reporting/surveys/:survey_id/responses/get.ts> (a function with typed inputs; its response is checked against the schema)

Get responses to a survey.

## Path parameters

- `survey_id` string, required

## Query parameters

- `fields` string[]
- `exclude_fields` string[]
- `answered_question` integer
- `chose_answer` string
- `respondent_familiarity_is` 'new' | 'known' | 'unknown'

## Response `200`

List of survey responses

- object
  - `_links` object[]: A list of link types and descriptions for the API schema documents.
    - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
    - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
    - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
    - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `responses` object[]: An array of responses to a survey.
    - `contact` object: Information about the contact.
      - `avatar_url` string: URL for the contact's avatar or profile image.
      - `consents_to_one_to_one_messaging` boolean: Indicates whether a contact consents to 1:1 messaging.
      - `contact_id` string: The ID of this contact.
      - `email` string: The contact's email address.
      - `email_id` string: The MD5 hash of the lowercase version of the list member's email address.
      - `full_name` string: The contact's full name.
      - `phone` string: The contact's sms phone number.
      - `status` 'Subscribed' | 'Unsubscribed' | 'Non-Subscribed' | 'Cleaned' | 'Archived': The contact's current status.
    - `is_new_contact` boolean: If this contact was added to the Mailchimp audience via this survey.
    - `response_id` string: The ID for the survey response.
    - `submitted_at` string, date-time: The date and time when the survey response was submitted in ISO 8601 format.
  - `total_items` integer: The total number of items matching the query regardless of pagination.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)