Skip to content

Hedge Broker API

The Hedge broker API quotes Hedge Instant Quote markets from your own software. It follows the same steps as the broker portal: check which markets fit, read what each one needs, create the file, answer the gaps, request quotes, download the quote PDFs, and get the link to bind.

appetite ──► requirements ──► create ──► answer ──► quote ──► quotes + PDFs ──► bind link
(read) (read) (submit) (submit) (submit) (read) (submit)

1. Appetite

POST /broker/appetite/instant: which instant markets will quote this state, these lines and this class. When none fits, email_us says what to email instead.

2. Requirements

POST /broker/requirements: the file’s core fields plus each chosen market’s own questions, per market, with types, options and validations.

3. Create

POST /broker/submissions (structured) or POST /broker/intake (documents and text). Returns each market’s state and what it still needs. client_reference makes the call safe to retry.

4. Answer

PATCH /broker/submissions/{id}/answers: answer by canonical key once and every market that asks it is filled, or answer one market’s own questions.

5. Quote

POST /broker/submissions/{id}/quote requests every ready market, or create with quote: true and each market quotes as soon as it is ready.

6. Quotes and PDFs

GET /broker/submissions/{id}/quotes: itemized pricing, coverages and subjectivities, with Hedge’s quote PDF and the carrier’s documents.

7. Bind link

POST /broker/submissions/{id}/quotes/{quote_id}/bind-link: the portal’s bind checklist for that quote, or the insured’s pay-and-bind page.

Status and events

GET .../instant-quotes for one file, GET /broker/events across your brokerage, or webhooks. Notifications follow your settings.

They share one API, one OAuth 2.1 model and one set of scopes.

  • Read is self-serve. Create a read key in the broker portal under Settings → API keys, or sign in with the CLI or the MCP connector. Any appointed brokerage can check appetite and requirements and read its own files, quotes and documents.
  • Submit (create, answer, quote, bind link) is turned on per brokerage by Hedge. A brokerage admin requests it in the portal. Until it is on, tokens are issued read-only.

See Authentication.

https://api.hedgespecialty.com/api/v1 production
https://sandbox-api.hedgespecialty.com/api/v1 sandbox

Build against the sandbox first: real carrier test systems, test quotes, and email only to your own sandbox users. Every request carries a short-lived OAuth 2.1 bearer token, and all data is scoped to the brokerage the token belongs to. Changes are additive on this version; breaking changes ship as a new version with notice.