---
title: "Every open ask on the submission, with the markets it unblocks"
method: GET
path: "/broker/submissions/{submission_id}/asks"
tags: ["Requirements"]
---

# Every open ask on the submission, with the markets it unblocks

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

## Request

- Base URL: `https://api.hedgespecialty.com/api/v1`
- URL: `https://api.hedgespecialty.com/api/v1/broker/submissions/{submission_id}/asks`
- 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 row per thing Hedge still needs from you on this submission:
unmet market requirements, carrier application questions, facts the
record lacks for a market's application, and documents. Each row
names the markets waiting on it (with their group), where the answer
lands, and whether and when Hedge asked for it. A row leaves the
list once the record satisfies it. Deterministic and read-only.

## Path parameters

- `submission_id` string, uuid, required

## Response `200`

Open asks, the ones markets are waiting on first

- object
  - `submission_id` string, uuid
  - `updating` boolean: A market's application is still preparing its questions (for example, just after a line was added). `items` is what is known so far, never "nothing owed"; read again once it is false.
  - `items` object[]
    - `key` string: Stable ask key; send it as `ask_key` when uploading a document for it
    - `label` string
    - `source` 'requirement' | 'carrier_question' | 'entry' | 'advisory' | 'ledger'
    - `repr` 'structured' | 'file' | 'form' | 'free_text'
    - `input` string, nullable
    - `options` object[]
      - `value` string
      - `label` string
    - `how_to_provide` string, nullable
    - `markets` object[]
      - `submission_market_id` string, uuid, nullable
      - `market_id` string, uuid, nullable
      - `program_id` string, uuid, nullable
      - `application_id` string, uuid, nullable
      - `name` string
      - `category` 'instant_quote' | 'binding' | 'specialty', nullable
    - `owner` 'broker'
    - `stage` 'quote' | 'bind'
    - `target` object
      - `brief_path` string, nullable
      - `application_id` string, uuid, nullable
      - `field_key` string, nullable
      - `document_type` string, nullable
    - `status` 'open' | 'asked' | 'answered_pending'
    - `asked_at` string, date-time, nullable
    - `asked_via` string, nullable
    - `reminded_at` string, date-time, nullable
    - `hold` boolean: A market is waiting on this ask
    - `detail` string, nullable: The statement an attestation or acknowledgement asks you to confirm, in full
    - `portal_url` string, nullable: The broker portal link that opens the submission at this ask

## Other responses

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

## Changes

- **2026-10-30** `36164d18db16`: 2 info
  - added the optional property `items/items/detail` to the response with the `200` status
  - added the optional property `items/items/portal_url` to the response with the `200` status
- **2026-10-26** `fdf9a4d8ffa7`: 1 info
  - added the optional property `updating` to the response with the `200` status
- **2026-10-22** `f51fe7503e9c`: 1 info
  - endpoint added

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