---
title: "Each Hedge Instant Quote market on the file and where it stands"
method: GET
path: "/broker/submissions/{submission_id}/instant-quotes"
tags: ["Submissions"]
---

# Each Hedge Instant Quote market on the file and where it stands

`GET /broker/submissions/{submission_id}/instant-quotes`

## Request

- Base URL: `https://api.hedgespecialty.com/api/v1`
- URL: `https://api.hedgespecialty.com/api/v1/broker/submissions/{submission_id}/instant-quotes`
- 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 file's state, the same body `POST /broker/submissions` returns:
each market's `state`, `status_label`, `missing[]` (exactly what it
still needs), `reason` when closed and `quote` when quoted, plus
`suggested[]` (values Hedge picked that you confirm). Poll this
every 5 to 10 seconds while markets are `preparing` or `quoting`.
Read scope.

## Path parameters

- `submission_id` string, uuid, required

## Response `200`

The file's state

- FileState
  - `submission_id` string, uuid, required
  - `client_reference` string, nullable
  - `portal_url` string, required
  - `automatic_quoting` boolean, required: Created with `quote: true`: each market quotes as soon as it is ready.
  - `markets` FlowMarket[], required
    - `program_id` string, uuid, required
    - `program` string, required
    - `market_id` string, uuid, nullable
    - `market` string, required
    - `lines` string[]
    - `state` 'preparing' | 'needs_answers' | 'ready' | 'quoting' | 'quoted' | 'declined' | 'not_a_fit', required: `preparing`: Hedge is preparing the application (poll). `needs_answers`: answer `missing[]`. `ready`: request the quote. `quoting`: requested. `quoted`: `quote` is set. `declined` / `not_a_fit`: closed, with `reason`.
    - `status_label` string, required: Plain words: Preparing · Needs 2 answers · Ready to quote · Quoting · Quoted · $1,234.00 · Declined · reason · Not a fit · reason.
    - `missing` FlowMissing[], required
      - `key` string, nullable: The canonical key (what `shared_answers` takes); null for a file-level gap.
      - `id` string, nullable: The market's own question id (what `answers[program_id]` takes).
      - `label` string, required
      - `message` string, required: Plain-language note on what to do. A gap in the business's own name, address, contact or effective date names the call that sets it: `PATCH /broker/submissions/{id}/business` and its field.
    - `reason` string, nullable
    - `quote` FlowQuote
      - `quote_id` string, required
      - `kind` 'quote' | 'indication', required
      - `premium` number, nullable: Dollars.
      - `total` number, nullable: Dollars
  - `suggested` FlowSuggestion[], required
    - `program_id` string, uuid, required
    - `key` string, nullable
    - `id` string, required
    - `label` string, required
    - `value` unknown, required
    - `value_label` string, nullable
    - `message` string, required
  - `warnings` string[], required

## Other responses

- `404`: Not your brokerage's submission

## Changes

- **2026-10-30** `0f8285056456`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/changes/broker/submissions/:submission_id/instant-quotes/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)