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

# List survey question reports

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

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/reporting/surveys/{survey_id}/questions`
- 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/questions/get.ts> (a function with typed inputs; its response is checked against the schema)

Get reports for survey questions.

## Path parameters

- `survey_id` string, required

## Query parameters

- `fields` string[]
- `exclude_fields` string[]

## Response `200`

List of Survey Question Report Instances

- 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.
  - `questions` object[]: An array of reports for each question on the survey.
    - `average_rating` number, float: The average rating for this range question.
    - `contact_counts` object: For email question types, how many are new, known, or unknown contacts.
      - `known` integer: The number of known contacts that responded to this survey.
      - `new` integer: The number of new contacts that responded to this survey.
      - `unknown` integer: The number of unknown contacts that responded to this survey.
    - `has_other` boolean: Whether this survey question has an 'other' option.
    - `id` string: The ID of the survey question.
    - `is_required` boolean: Whether this survey question is required to answer.
    - `merge_field` object: A [merge field](https://mailchimp.com/developer/marketing/docs/merge-fields/) for an audience.
      - `id` integer: An unchanging id for the merge field.
      - `label` string: The [label](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for the merge field.
      - `type` 'text' | 'number' | 'address' | 'phone' | 'date' | 'url' | 'imageurl' | 'radio' | 'dropdown' | 'birthday' | 'zip': The [type](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for the merge field.
    - `options` object[]: The answer choices for this question.
      - `count` integer: The count of responses that selected this survey question option.
      - `id` string: The ID for this survey question option.
      - `label` string: The label for this survey question option.
    - `other_label` string: Label used for the 'other' option of this survey question.
    - `placeholder_label` string: Placeholder text for this survey question's answer box.
    - `query` string: The query of the survey question.
    - `range_high_label` string: Label for the high end of the range.
    - `range_low_label` string: Label for the low end of the range.
    - `subscribe_checkbox_enabled` boolean: Whether the subscribe checkbox is shown for this email question.
    - `subscribe_checkbox_label` string: Label used for the subscribe checkbox for this email question.
    - `survey_id` string: The unique ID of the survey.
    - `total_responses` integer: The total number of responses to this question.
    - `type` 'pickOne' | 'pickMany' | 'range' | 'text' | 'email' | 'contactInformation' | 'dropdown': The response type of the survey question.
  - `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)