---
title: "Read the available and selected supplemental applications"
method: GET
path: "/broker/submissions/{submission_id}/supplemental-forms"
tags: ["Carrier quotes"]
---

# Read the available and selected supplemental applications

`GET /broker/submissions/{submission_id}/supplemental-forms`

## Request

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

Read the current supplemental-form catalog, the submission's selected
form keys, and its derived Hedge application when a selection exists.
Read scope is enough. This is available on Hedge-owned structured
submissions. Choosing forms requires an unrestricted broker portal
session; that write operation is not available to OAuth clients.

## Path parameters

- `submission_id` string, uuid, required

## Response `200`

Available forms and current selection

- object
  - `forms` object[], required
    - `form_key` string, required
    - `title` string, required
    - `selected` boolean, required
  - `selected_form_keys` string[], required
  - `application` ApplicationSection, required: One carrier application (a carrier-API quote session) inside the workspace: its schema, current answers, per-field ownership, and readiness. `application_id` is the `session_id` used by the checkpoint / request-quote / employers-classes paths. Revisions (`answer_revision`, `fact_revision`, `selection_revision`) and `schema_fingerprint` are the optimistic-concurrency tokens every command must echo.
    - `application_id` string, required
    - `workspace_id` string, required
    - `connection_id` string
    - `provider_key` string, required
    - `program_identifier` string, required
    - `owner_host` 'hedge' | 'bindly'
    - `owner_session_id` string
    - `route` 'hedge' | 'direct'
    - `market_program_id` string, uuid, nullable
    - `submission_id` string, uuid, nullable
    - `line_of_business` string, nullable
    - `schema` object, required: The normalized question schema (fields, required_field_keys, program identity); the same questions GET /broker/programs/{program_id}/application-schema projects.
    - `schema_fingerprint` string, required
    - `answers` object, required: Current answers keyed by question key.
    - `ownership` object
    - `answer_revision` integer, required
    - `fact_revision` integer
    - `selection_revision` integer
    - `selected_products` string[]
    - `available_products` string[]
    - `mapping_state` string: Whether Hedge's fact-to-answer mapping is idle or still running for this application.
    - `unresolved_dependencies` string[]
    - `missing` string[]: Required question keys still unanswered.
    - `errors` object[]
    - `visible_fields` string[]
    - `readiness` string, required: `needs_information` until every required visible question is answered, then `ready_for_quote`.
    - `request_state` string, required: Lifecycle of the last quote request for this application (draft until one is made).
    - `request_id` string, nullable
    - `result` object, nullable: The carrier outcome of the last request
    - `allowed_actions` string[]

## Other responses

- `404`: Submission not found (or not your brokerage's)
- `409`: This submission uses its existing application workflow

## Changes

- **2026-11-10** `3b42e3aab00d`: 1 info
  - endpoint added

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