---
title: "Get Bulk Responses Request Status"
method: GET
path: "/responses/bulk/{request_id}"
tags: ["Lookup"]
---

# Get Bulk Responses Request Status

`GET /responses/bulk/{request_id}`

## Request

- Base URL: `https://api.morningconsult.com/v1`
- URL: `https://api.morningconsult.com/v1/responses/bulk/{request_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/morningconsult/apis/morning-consult-api/docs/responses/bulk/:request_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the status of a previously submitted bulk responses report request. When the report is complete, the response will include a `download_url` that can be used to download the report data.

## Path parameters

- `request_id` string, uuid, required

## Response `200`

Bulk Responses Request Status

- GetResponsesBulkStatusOutput
  - `request_id` string, uuid: The unique identifier for the bulk responses request.
  - `status` 'processing' | 'complete' | 'error': The current status of the report request.
  - `download_url` string, uri: URL to download the completed report. Only present when status is `complete`.
  - `expires_at` string, date-time: Expiration time of the download URL. Only present when status is `complete`.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/morningconsult/apis/morning-consult-api.md) - [All operations](https://skmtc.dev/morningconsult/apis/morning-consult-api/llms.txt) - [OpenAPI document](https://skmtc.dev/morningconsult/apis/morning-consult-api/revisions/70d621a9c59c?raw)