The market rail alone (cheap poll)

GET

/broker/submissions/{submission_id}/market-rail

const url = 'https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/market-rail';
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/market-rail \
  --header 'Authorization: Bearer <token>'

The per-lane block from the requirements view without its heavier sections; zero writes, safe to poll every few seconds while you watch a submission. GET .../requirements carries the same block under rail.

Authorizations

brokerOAuth

Parameters

Path Parameters

submission_id

required

string format: uuid

Responses

200

Market rail

application/json

object

generated_at

string format: date-time

lanes

Array<object>

One market lane on this submission, in the shape the broker portal renders.

object

submission_market_id

The lane id used across this API (lane_id elsewhere).

string format: uuid

market_id

string format: uuid

nullable

market_name

string

nullable

program

string

nullable

program_id

string format: uuid

nullable

program_category

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.

string

Allowed values: instant_quote binding specialty

lines

Array<string>

status

string

status_label

string

submit_ready

boolean

gapped

Held for something only you can supply (see unmet_labels).

boolean

unmet_labels

Array<string>

quotes

Array<object>

object

quote_id

string format: uuid

premium_display

string

total_cents

integer

lines

Array<string>

is_revision

boolean

nullable

source_offers

Carrier-original quote or indication documents.

Array<object>

object

presentation_id

string format: uuid

kind

string

Allowed values: quote indication

label

string

document_url

string

filename

string

nullable

bound

boolean

chip

string

Allowed values: bound quoted not_available needs_info in_progress

carrier_api_session_ids

Array<string>

nullable

quote_history

Expired or invalidated quotes, for context.

Array<object>

object

history_key

string

market_name

string

program

string

nullable

outcome

string

Allowed values: expired invalid

observed_at

string format: date-time

next_step

string

nullable

quote_history_unavailable

boolean

Example

{
  "lanes": [
    {
      "program_category": "instant_quote",
      "source_offers": [
        {
          "kind": "quote"
        }
      ],
      "chip": "bound"
    }
  ],
  "quote_history": [
    {
      "outcome": "expired"
    }
  ]
}

404

Not found (or not your brokerage’s)