---
title: "Get one submission (status, markets, documents)"
method: GET
path: "/broker/submissions/{submission_id}"
tags: ["Submissions"]
---

# Get one submission (status, markets, documents)

`GET /broker/submissions/{submission_id}`

## Request

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

The submission header (id, insured_name, lines, state, status_label,
premium, primary_state, effective_date, created_at, updated_at) plus
the live marketing roll-up:

- `markets`: one entry per engaged carrier with per-line rows
  (line, status, status_label, quote premium in cents and dollars,
  last update, decline/withdrawal notes).
- `status_summary`: counts by status and per-line quoted/total
  progress.
- `documents`: finalized documents on file, each with a
  `download_path` you can GET with the same bearer token. API
  credentials also see the quote documents: the carrier quote PDFs
  Hedge stored (`source: carrier_quote`) and Hedge's quote PDF for
  each released quote (`source: hedge_quote`). The quote read
  (`GET .../quotes`) lists the same documents per quote.
- `bor_actions`: Broker of Record workstreams, empty for most
  submissions.
- `origin`: null, or `{partner, label, mode}` when an API partner
  (Hedge Connector) created the submission; `mode` is `rater` while
  the partner is quoting it and `normal` after.

## Path parameters

- `submission_id` string, uuid, required

## Response `200`

Submission detail with marketing roll-up

## Other responses

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

---

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