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

# Get survey report

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

## Request

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

Get report for a survey.

## Path parameters

- `survey_id` string, required

## Query parameters

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

## Response `200`

Survey Report Instance

- object: The report for a survey.
  - `created_at` string, date-time: The date and time the survey was created in ISO 8601 format.
  - `id` string: A string that uniquely identifies this survey.
  - `list_id` string: The ID of the list connected to this survey.
  - `list_name` string: The name of the list connected to this survey.
  - `published_at` string, date-time: The date and time the survey was published in ISO 8601 format.
  - `status` 'published' | 'unpublished': The survey's status.
  - `title` string: The title of the survey.
  - `total_responses` integer: The total number of responses to this survey.
  - `updated_at` string, date-time: The date and time the survey was last updated in ISO 8601 format.
  - `url` string: The URL for the survey.
  - `web_id` integer: The ID used in the Mailchimp web application. View this survey report in your Mailchimp account at `https://{dc}.admin.mailchimp.com/lists/surveys/results?survey_id={web_id}`.

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