Every released quote on a submission, itemized, with each lane's status

GET

/broker/submissions/{submission_id}/quotes

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

• Production
• Sandbox (Hedge's staging environment; carrier test systems only)

The quote set is exactly what you see in the Hedge portal: released firm quotes only (indications and quotes whose terms Hedge is still confirming never appear as quotes). Each quote carries premium, taxes (with the surplus-lines split when it reconciles), fees, total and payment options in integer cents with currency: USD, plus coverages, subjectivities (with due_stage and status), issuing company, admitted status, dates, documents (Hedge’s quote PDF, kind: hedge_quote_pdf, plus the carrier’s; see QuoteDocument) and whether it can be bound now. Each lane carries its status (see QuoteLane), the assumptions Hedge recorded, and carrier original offers.

null means unknown, never zero. Deterministic and read-only; poll it, or re-read it after a webhook. revision changes whenever the lanes change. A partner acting for your brokerage reads only the submissions that partner created; others return 404 to it.

Authorizations

• brokerOAuth

Parameters

Path Parameters

submission_id

required

string format: uuid

Responses

200

The lanes and their released quotes

Media typeapplication/json

object

submission_id

required

string format: uuid

generated_at

required

string format: date-time

revision

required

Changes whenever anything in lanes changes.

string

lanes

required

Array<object>

object

lane_id

required

string format: uuid

program_id

string format: uuid

nullable

program_name

string

nullable

program_category

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

channel

string

nullable

Allowed values: api portal email

market

required

object

id

string format: uuid

nullable

slug

string

nullable

display_name

string

nullable

logo_url

string

nullable

lines

Array<string>

status

required

First match wins: bound (the carrier bound it; status_label reads “Bound, policy documents pending” until its policy is issued), binding (a live bind request), quoted (at least one quote in quotes), declined, blocked (another broker holds the account at this market), no_quote (withdrawn, or the submission closed), needs_info, indicated (a non-binding indication only; never priced here), pending.

string

Allowed values: bound binding quoted declined blocked no_quote needs_info indicated pending

status_label

required

string

status_reason

object

code

string

text

string

nullable

speed

A channel-level expectation (basis is channel_default), never a per-program promise.

object

hint

required

string

Allowed values: minutes within_day underwriter_review

label

required

string

basis

required

string

Allowed values: channel_default

needs_from_you

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

carrier_originals

Carrier original offers whose terms Hedge is still confirming.

Array<object>

download_path is an authenticated Hedge route (call it with the same token) that serves a PDF Hedge stored; carrier_url is a carrier-hosted https link (Coterie’s proposal, for example).

kind: hedge_quote_pdf is Hedge’s own quote PDF, the cover Hedge’s quote emails carry: the price with its taxes and fees, and the quote’s terms. It is listed first. Hedge prepares it when the quote is first read after release and again whenever the quote’s terms change, so a quote can list it a few seconds after the quote itself appears; read again to pick it up. Other kinds are the carrier’s documents (quote_pdf, quote_proposal, exclusion_form, …).

object

kind

string

nullable

file_name

string

nullable

download_path

string

nullable

carrier_url

string

nullable

quotes

Array<object>

One released firm quote, itemized. All money is integer cents with pricing.currency USD; null means unknown and never means zero. Prices are null when presentation.checkout_ready is false, exactly as the Hedge proposal withholds them. The surplus-lines tax split is filled only when Hedge’s pricing ledger agrees with the stored totals (pricing.breakdown_reconciled); otherwise only the tax total shows.

object

quote_id

required

string format: uuid

lane_id

required

string format: uuid

kind

required

string

Allowed values: firm

is_revision

Null while revision marking is off.

boolean

nullable

revision_of_quote_id

string format: uuid

nullable

created_at

string format: date-time

nullable

carrier

required

object

display_name

string

nullable

logo_url

string

nullable

mga_name

string

nullable

issuing_company

object

legal_name

string

nullable

naic

string

nullable

am_best_rating

string

nullable

admitted

required

string

Allowed values: admitted non_admitted unknown

program_name

string

nullable

quote_number

string

nullable

lines

Array<string>

effective_date

string format: date

nullable

expiration_date

string format: date

nullable

quote_expires_on

string format: date

nullable

presentation

required

object

mode

string

Allowed values: full_summary source_only

financial_status

string

terms_status

string

checkout_ready

boolean

pricing

required

object

currency

string

Allowed values: USD

basis

string

Allowed values: term

premium_cents

integer

nullable

taxes

object

total_cents

integer

nullable

surplus_lines_tax_cents

integer

nullable

stamping_fee_cents

integer

nullable

other_cents

integer

nullable

computed_by

string

nullable

Allowed values: inscipher

fees

object

total_cents

integer

nullable

carrier_fees_cents

integer

nullable

hedge_broker_fee_cents

integer

nullable

total_cents

integer

nullable

breakdown_reconciled

boolean

payment_options

Array<object>

object

key

string

Allowed values: in_full monthly

total_cents

integer

nullable

down_payment_cents

integer

nullable

installment_cents

integer

nullable

installments

integer

nullable

disclaimer

string

nullable

coverages

Array<object>

object

key

string

nullable

label

string

nullable

limit_text

string

nullable

deductible_text

string

nullable

note

string

nullable

primary_limit_cents

Strict parse of the first coverage row’s limit; null when absent or ambiguous.

integer

nullable

primary_deductible_cents

integer

nullable

endorsements

Array<object>

object

key

string

nullable

name

string

nullable

description

string

nullable

limit

string

nullable

subjectivities

Array<object>

object

id

string format: uuid

kind

string

prompt

string

optional

boolean

due_stage

string

nullable

status

string

nullable

notes

Array<string>

compliance_notices

object

documents

Array<object>

download_path is an authenticated Hedge route (call it with the same token) that serves a PDF Hedge stored; carrier_url is a carrier-hosted https link (Coterie’s proposal, for example).

kind: hedge_quote_pdf is Hedge’s own quote PDF, the cover Hedge’s quote emails carry: the price with its taxes and fees, and the quote’s terms. It is listed first. Hedge prepares it when the quote is first read after release and again whenever the quote’s terms change, so a quote can list it a few seconds after the quote itself appears; read again to pick it up. Other kinds are the carrier’s documents (quote_pdf, quote_proposal, exclusion_form, …).

object

kind

string

nullable

file_name

string

nullable

download_path

string

nullable

carrier_url

string

nullable

bind

required

object

available

boolean

blocked_reason

bound / bind_in_progress: this lane is bound or has a live bind request. line_bound_elsewhere: the same coverage line is bound or binding on another lane. closed_at_carrier: the carrier closed this quote. not_bindable: not bindable terms (for example awaiting carrier approval). incomplete_terms: not checkout-ready (prices are withheld). expired: past quote_expires_on.

string

nullable

Allowed values: bound bind_in_progress line_bound_elsewhere closed_at_carrier not_bindable incomplete_terms expired

Example

{
  "lanes": [
    {
      "program_category": "instant_quote",
      "channel": "api",
      "status": "bound",
      "speed": {
        "hint": "minutes",
        "label": "Usually within minutes",
        "basis": "channel_default"
      },
      "carrier_originals": [
        {
          "kind": "hedge_quote_pdf"
        }
      ],
      "quotes": [
        {
          "kind": "firm",
          "admitted": "admitted",
          "presentation": {
            "mode": "full_summary"
          },
          "pricing": {
            "currency": "USD",
            "basis": "term",
            "taxes": {
              "computed_by": "inscipher"
            },
            "payment_options": [
              {
                "key": "in_full"
              }
            ]
          },
          "subjectivities": [
            {
              "due_stage": "pre_bind",
              "status": "open"
            }
          ],
          "documents": [
            {
              "kind": "hedge_quote_pdf"
            }
          ],
          "bind": {
            "blocked_reason": "bound"
          }
        }
      ]
    }
  ]
}

404

Not found (or not your brokerage’s)