---
title: "Download a submission's package as a ZIP"
method: POST
path: "/broker/submissions/{submission_id}/package/download"
tags: ["Documents"]
---

# Download a submission's package as a ZIP

`POST /broker/submissions/{submission_id}/package/download`

## Request

- Base URL: `https://api.hedgespecialty.com/api/v1`
- URL: `https://api.hedgespecialty.com/api/v1/broker/submissions/{submission_id}/package/download`
- Auth: OAuth 2
  - Authorization code: `https://api.hedgespecialty.com/api/v1/oauth/authorize`
  - Client credentials
  - Token URL: `https://api.hedgespecialty.com/api/v1/oauth/token`

A ZIP of the risk summary PDF (listing the documents it goes with)
and the stored originals of the chosen documents; fillable forms stay
fillable. Send `document_ids` to choose exactly which documents (each
must be one of the package's), or omit it for the ticked set. Set
`include_summary` to false to leave the summary out.

## Path parameters

- `submission_id` string, uuid, required

## Request body

- object
  - `document_ids` string[]
  - `include_summary` boolean

## Response `200`

The package

## Other responses

- `404`: Not found (or not your brokerage's)
- `413`: The chosen documents are too large for one download (over 200 MB)
- `422`: A document id that isn't part of this package
- `502`: A stored document could not be retrieved; the message names it

## Changes

- **2026-10-24** `a3e31248a54a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/changes/broker/submissions/:submission_id/package/download/post.md)

---

[API](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api.md) - [All operations](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/revisions/beefa9cdc11c?raw)