What this submission still needs

GET

/broker/submissions/{submission_id}/requirements

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

brokerOAuth

Parameters

Path Parameters

submission_id

required

string format: uuid

Responses

200

Requirements view

application/json

The live “what’s still needed” view.

object

submission_id

string format: uuid

insured_name

string

lines

Array<string>

effective_date

string format: date

state

string

forms

Application forms Hedge prepares for this risk (ACORD baseline + recommended carrier supplements).

Array<string>

marketing_status

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”.

string

Allowed values: not_started matching matched no_markets_matched

marketing_hint

Human-readable next step for the current marketing_status.

string

nullable

markets

Array<object>

object

market_name

string

ready

boolean

needs_from_you

Array<string>

hedge_obtains

Array<string>

carrier_api_sessions

Array<object>

object

session_id

string format: uuid

carrier_slug

string

program

string

status

string

completion_pct

number

missing_questions

Array<object>

object

has_quote

boolean

documents_on_file

Array<object>

object

kind

string

kind_label

string

display_name

string

Example

{
  "marketing_status": "not_started"
}