---
title: "Read a submission's package"
method: GET
path: "/broker/submissions/{submission_id}/package"
tags: ["Documents"]
---

# Read a submission's package

`GET /broker/submissions/{submission_id}/package`

## Request

- Base URL: `https://api.hedgespecialty.com/api/v1`
- URL: `https://api.hedgespecialty.com/api/v1/broker/submissions/{submission_id}/package`
- 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`

What you send your own markets for one of your submissions: its risk
summary and the application documents to go with it.

`summary` has `status` (`none` until one is written, then `ready`),
`text`, `sections`, `generated_at` and `stale` (true once the file's
facts changed after it was written; a portal session regenerates it).
The text is written for an underwriter from the file's own facts and
every answer given on it, and lists no documents: add the ones you
send. `sections` is the same summary as titled sections in display
order, each with `items` (`label`, null for a plain line, and a
formatted `value`) and `in_copy`: the sections where it is false
(answers that differ between applications, and what Hedge assumed to
get a quote) are for you and are never in the text.

`groups` lists the documents: `forms` (the current version of each
form Hedge prepared), `prefilled` (your ready "Get a form" copies) and
`documents` (what you uploaded or emailed). Each has `id`,
`file_name`, `attachment_label`, `selected` (ticked by default) and,
when it isn't ticked, a `note` saying why: a fill Hedge's checks
doubt, another market's quote or binder, a blank copy or a broker of
record letter. Carrier quote PDFs, bind uploads and internal filing
paperwork are never listed.

## Path parameters

- `submission_id` string, uuid, required

## Response `200`

The package

## Other responses

- `404`: Not found (or not your brokerage's)

## 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/get.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)