Start marketing (the explicit "go shop it")

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

Hedge matches carrier markets and prepares submissions; each still passes your brokerage’s approval gates. Matching is asynchronous - it usually completes within about 5 minutes (typical_wait_seconds). Poll the requirements endpoint: its marketing_status flips to matched when lanes attach and distinguishes still-matching from no-appetite. (The submission detail’s markets list only shows markets Hedge has actually contacted, which can be later, after your brokerage’s approval gates.)

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
}