---
title: "One carrier application from the workspace"
method: GET
path: "/broker/submissions/{submission_id}/applications/{session_id}"
tags: ["Carrier quotes"]
---

# One carrier application from the workspace

`GET /broker/submissions/{submission_id}/applications/{session_id}`

## Request

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

One carrier application, presented exactly as the
application-workspace read presents it, so a client can refresh a
single application after a `changed` event. `session_id` is the
`ApplicationSection.application_id`. 404 with `code: read_workspace`
means read the whole workspace instead: the application is a Hedge
or legacy application, its session was withdrawn, or it is outside
the selected quoting scope. Read scope is enough.

## Path parameters

- `submission_id` string, uuid, required
- `session_id` string, uuid, required

## Response `200`

The application

- object
  - `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), or `code: read_workspace`

## Changes

- **2026-10-10** `7c21970d5f33`: 1 info
  - endpoint added

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