What this submission still needs
const url = 'https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/requirements';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/requirements \ --header 'Authorization: Bearer <token>'The contract centerpiece, per-market readiness (needs_from_you =
items only you can supply), live carrier question gaps, the resolved
form set, and documents already on file. Deterministic and fast; poll
it between uploads/answers and finalize.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”Requirements view
The live “what’s still needed” view.
object
Application forms Hedge prepares for this risk (ACORD baseline + recommended carrier supplements).
Where the asynchronous marketing pipeline is. Matching runs for
a few minutes after finalize, so an empty markets list means
“still matching” when this is matching; not “no appetite”.
Human-readable next step for the current marketing_status.
A live form-fill session owns the form set.
Per-market readiness (deterministic, no model on this read).
object
Items only you can supply.
Items Hedge fetches itself; informational.
The market lane this row belongs to (same id as rail.lanes[].submission_market_id).
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.
The broker label from the program’s authority: specialty when a carrier underwriter reviews every file (any channel); instant_quote for a binding API program; binding for a binding portal or email program. program_category is the route.
Instant-quote (carrier API) sessions and their open question gaps.
object
object
object
The canonical per-program requirements assessment (null if that section failed to build).
object
object
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.
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.
object
Hard or preferred
Broker (you supply), auto (Hedge fetches) or internal
Structured, free_text, form or file
Quote or bind
object
Hard or preferred
Broker (you supply), auto (Hedge fetches) or internal
Structured, free_text, form or file
Quote or bind
object
Hard or preferred
Broker (you supply), auto (Hedge fetches) or internal
Structured, free_text, form or file
Quote or bind
The per-lane market rail, the same block the broker portal shows (null if that section failed to build).
object
One market lane on this submission, in the shape the broker portal renders.
object
The lane id used across this API (lane_id elsewhere).
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.
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.
A closed market’s reason. Beside “Declined”, the carrier’s own words; beside “Not a fit”, one fixed reason.
Held for something only you can supply (see unmet_labels).
object
Carrier-original quote or indication documents.
object
Expired or invalidated quotes, for context.
object
Lines (canonical slugs) online markets are still quoting without
having been named to you yet. Show one unnamed “Online quotes in
progress” line each; the markets appear in lanes once they
quote, decline or ask you something.
Lines (canonical slugs) no market is working or shows; every market on them closed.
Example
{ "marketing_status": "not_started", "markets": [ { "program_category": "instant_quote", "category_label": "Hedge Instant Quote", "broker_label": "instant_quote" } ], "assessment": { "programs": [ { "channel": "email", "program_category": "instant_quote", "broker_label": "instant_quote", "enforcement": "enforce" } ] }, "rail": { "lanes": [ { "program_category": "instant_quote", "broker_label": "instant_quote", "source_offers": [ { "kind": "quote" } ], "chip": "bound" } ], "quote_history": [ { "outcome": "expired" } ] }}