Release a held submission

POST

/broker/submissions/{submission_id}/finalize

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>'

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.

Authorizations

brokerOAuth

Parameters

Path Parameters

submission_id

required

string format: uuid

Responses

202

Queued; matching runs asynchronously.

application/json

object

status

string

marketing_status

string

typical_wait_seconds

integer

detail

string

Example

{
  "status": "queued",
  "marketing_status": "matching",
  "typical_wait_seconds": 300
}