Skip to content
Hedge Developer Docs

The markets being tried, in three categories, with asks, assumptions and quotes

GET
/broker/submissions/{submission_id}/markets
curl --request GET \
  --url https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/markets \
  --header 'Authorization: Bearer <token>'

The live picture of the run, grouped the way the clearance email lists it: Hedge Instant Quote (instant_quote, connected carrier APIs quoted on recorded favorable assumptions), Hedge Binding (binding, markets Hedge quotes for you) and Hedge Specialty (specialty, email markets that need completed ACORDs, program requirements and loss runs). All three categories are always present, in that order, even when empty.

Each lane carries its status, submit_ready, needs_from_you (the broker-actionable asks, only while the lane is gapped), assumptions (each a pre-bind attestation the producer must confirm; confirmed: false means still standing) and released quotes. Deterministic and read-only; poll it after create - matching usually lands within about 5 minutes, and an empty view during matching is not “no appetite”.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
submission_id
required
string format: uuid

Responses

Section titled “Responses”

200

Section titled “200”

The three market categories

Media typeapplication/json
object
submission_id
required
string format: uuid
generated_at
required
string format: date-time
categories
required

Always all three categories, in order instant_quote, binding, specialty, empty ones included.

Array<object>
object
category
required

The Hedge category of a market program, derived from how Hedge submits to it. instant_quote (“Hedge Instant Quote”): carrier API, Hedge fills gaps with favorable assumptions and quotes in minutes; every assumption is listed for the retail agent to confirm before bind. binding (“Hedge Binding”): carrier portal, Hedge quotes on your behalf. specialty (“Hedge Specialty”): email to an underwriter; completed ACORDs, program supplements and loss runs are needed and a human reads them, so Hedge does not assume.

string
Allowed values: instant_quote binding specialty
label
required

Hedge Instant Quote, Hedge Binding, or Hedge Specialty.

string
description
required
string
lanes
required
Array<object>
object
lane_id
required
string format: uuid
market_id
string format: uuid
nullable
market_name
string
nullable
program
string
nullable
program_id
string format: uuid
nullable
program_category
required

The Hedge category of a market program, derived from how Hedge submits to it. instant_quote (“Hedge Instant Quote”): carrier API, Hedge fills gaps with favorable assumptions and quotes in minutes; every assumption is listed for the retail agent to confirm before bind. binding (“Hedge Binding”): carrier portal, Hedge quotes on your behalf. specialty (“Hedge Specialty”): email to an underwriter; completed ACORDs, program supplements and loss runs are needed and a human reads them, so Hedge does not assume.

string
Allowed values: instant_quote binding specialty
lines
Array<string>
status
required
string
status_label
required
string
submit_ready
required
boolean
needs_from_you

Broker-actionable asks, present only while the lane is gapped.

Array<string>
assumptions
Array<object>

One favorable default a carrier adapter filed on the broker’s behalf to obtain an instant quote. Every assumption is a pre-bind attestation the producer must confirm; confirmed is false while it still stands on the carrier session and true once the broker’s confirmation retired it.

object
key
required
string
label
required
string
value
nullable
confirmed
required
boolean
quotes
Array<object>

A released, firm quote on the lane (indications never appear here).

object
quote_id
required
string format: uuid
premium_cents
required
integer
premium
required
string
lines
Array<string>
is_revision

Present only when this quote supersedes an earlier released price.

boolean
bound
required
boolean
Example
{
  "categories": [
    {
      "category": "instant_quote",
      "lanes": [
        {
          "program_category": "instant_quote",
          "quotes": [
            {
              "premium": "$8,559"
            }
          ]
        }
      ]
    }
  ]
}

404

Section titled “404”

Not found (or not your brokerage’s)