Release a held submission
const url = 'https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/finalize';const options = {method: 'POST', 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 POST \ --url https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/finalize \ --header 'Authorization: Bearer <token>'A file a connected app or machine credential created quotes Hedge
Instant Quote markets only and has nothing to release: this returns
409 use_quote for it (answer with PATCH .../answers, request
quotes with POST .../quote).
Starts the run for a submission created with hold: true (or with
an expected-documents manifest): Hedge matches carrier markets,
sends the clearance email to the producer, opens the lanes and
quotes the instant-quote markets. Idempotent, on a submission whose
run already started (a default create, or an earlier finalize) it
returns the same 202 without starting anything twice.
Matching is asynchronous; it usually completes within about 5
minutes (typical_wait_seconds). Poll
GET /broker/submissions/{id}/markets for the three categories, or
the requirements endpoint, whose marketing_status flips to
matched when lanes attach and distinguishes still-matching from
no-appetite.
A mode: rater submission (partner integrations) instead opens its
chosen programs synchronously: marketing_status is quoting with
lanes and not_opened (each program’s reasons), or closed when
none of them can quote. A 422 rater_start_failed leaves the file
held (for example, no requested line or risk state could be read).
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”Queued; matching runs asynchronously.
object
Example
{ "status": "queued", "marketing_status": "matching", "typical_wait_seconds": 300}use_quote: an instant-flow file has nothing to finalize