Submit the bind request to Hedge for placement

POST

/broker/submissions/{submission_id}/bind-requests/{bind_request_id}/submit

const url = 'https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/bind-requests/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/submit';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"attest_assumptions":false,"producer_email":"example"}'
};

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/bind-requests/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "attest_assumptions": false, "producer_email": "example" }'

The wizard’s own submit, same validation: the request moves from drafted to submitted and Hedge places the bind with the carrier (your brokerage’s approval settings decide whether a Hedge reviewer looks first). While assumptions remain unconfirmed this answers 409 assumptions_unconfirmed, pass attest_assumptions in the body to confirm and submit in one call. Surplus-lines placements need a diligent search on file (422 says so); direct-bill card-payment lanes are portal-only (422). A bound event follows on the events feed and webhooks once the carrier binds.

Authorizations

brokerOAuth

Parameters

Path Parameters

submission_id

required

string format: uuid

bind_request_id

required

string format: uuid

Request Body

application/json

object

attest_assumptions

One of:

boolean
Array<string>

boolean

producer_email

REQUIRED with a machine credential.

string

Responses

200

The submitted bind request

application/json

object

bind_request_id

required

string format: uuid

submission_id

required

string format: uuid

status

required

drafted: checklist open (upload documents, confirm assumptions, then submit). submitted/sent: Hedge is placing the bind with the carrier. binder_received/bound: the placement completed (the policy appears under GET /broker/policies and a bound event is emitted). bind_failed: Hedge is reviewing.

string

Allowed values: drafted submitted sent binder_received bound bind_failed cancelled declined expired

status_label

required

string

quote_id

string format: uuid

nullable

payment_option

string

nullable

requested_at

required

string format: date-time

requested_by

The producing broker the request is attributed to.

string

nullable

effective_date

string format: date

nullable

policy_id

string format: uuid

nullable

unconfirmed_assumptions

required

Standing assumptions the retail agent still has to confirm. Non-empty means create/submit will answer 409 assumptions_unconfirmed until attested.

Array<object>

One assumption Hedge made to obtain the quote (a value it defaulted on the carrier application because the file did not state it) that the retail agent has not yet confirmed. key is what attest_assumptions lists; label is the plain-language statement; value is the exact value asserted to the carrier (absent when the entry records none).

object

key

required

string

label

required

string

value

The asserted value

contingencies

required

Array<object>

One pre-bind item the carrier needs, with your response state.

object

required

string format: uuid

kind

required

string

Allowed values: question signed_form loss_runs file_upload

label

required

The carrier’s wording of the item.

string

status

required

string

Allowed values: pending satisfied waived

required

required

boolean

upload_path

While the request is drafted, the path to POST a PDF for this item (multipart file); null afterwards.

string

nullable

esign_status

Envelope state of a signature request started for this item through the Hedge portal wizard (e.g. sent, completed, queued_for_review); null when none.

string

nullable

next_steps

required

Plain-language actions for the current state, in order.

Array<string>

Example

{
  "status": "drafted",
  "contingencies": [
    {
      "kind": "question",
      "status": "pending"
    }
  ]
}

403

Broker_submit scope required

404

Submission or bind request not found

409

Assumptions unconfirmed, already submitted, or the selected quote changed

application/json

object

detail

One of:

object
string

409 body from create/submit. The bind request exists as a draft (bind_request_id); re-POST the create (idempotent for the same quote) or POST submit with attest_assumptions to confirm.

object

code

required

string

Allowed value: assumptions_unconfirmed

message

required

string

bind_request_id

required

string format: uuid

assumptions

required

Array<object>

object

key

required

string

label

required

string

value

The asserted value

Example

{
  "detail": {
    "code": "assumptions_unconfirmed"
  }
}

422

Not yet submittable (effective date out of range