Hedge Market access API

openapi: 3.2.0
info:
  title: Hedgespecialty Com Market access API
  version: '1.0'
  description: 'Operations tagged Market access across 2 of this provider''s published API definitions: hedge-openapi.json, hedgespecialty-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.hedgespecialty.com/api/v1
  description: Production
- url: https://staging-api.hedgespecialty.com/api/v1
  description: Staging sandbox
security:
- brokerOAuth: []
tags:
- name: Market access
paths:
  /broker/market-access:
    get:
      tags:
      - Market access
      operationId: getMarketAccess
      summary: The markets this brokerage receives quotes from, with per-program and per-line…
      description: One row per market Hedge has enabled for your brokerage, each with its per-program breakdown and each program's line switches. A toggle that is off stops NEW submissions from being marketed there; in-flight submissions are unaffected. Readable by any signed-in broker user.
      responses:
        '200':
          description: 'Rows of {market_id, name, enabled, programs: [{program_id, name, description, enabled, lines: [{slug, label, enabled}]}]}'
    put:
      tags:
      - Market access
      operationId: setMarketAccess
      summary: Turn a whole market on or off (admin)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - market_id
              - enabled
              properties:
                market_id:
                  type: string
                  format: uuid
                enabled:
                  type: boolean
      responses:
        '200':
          description: The refreshed market-access table
        '403':
          description: Admin role required
        '404':
          description: Market not visible to this brokerage
    servers:
    - url: https://api.hedgespecialty.com/api/v1
      description: Production
    - url: https://staging-api.hedgespecialty.com/api/v1
      description: Staging sandbox
  /broker/market-access/program:
    put:
      tags:
      - Market access
      operationId: setProgramAccess
      summary: Turn one program of a market on or off (admin)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - program_id
              - enabled
              properties:
                program_id:
                  type: string
                  format: uuid
                enabled:
                  type: boolean
      responses:
        '200':
          description: The refreshed market-access table
        '403':
          description: Admin role required
        '404':
          description: Program not visible to this brokerage
    servers:
    - url: https://api.hedgespecialty.com/api/v1
      description: Production
    - url: https://staging-api.hedgespecialty.com/api/v1
      description: Staging sandbox
  /broker/market-access/program-line:
    put:
      tags:
      - Market access
      operationId: setProgramLineAccess
      summary: Turn a single line of business within a program on or off (admin)
      description: Toggles one line the program lists (see the program's lines in GET /broker/market-access). Turning off every line a program lists is equivalent to turning the program off.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - program_id
              - lob_slug
              - enabled
              properties:
                program_id:
                  type: string
                  format: uuid
                lob_slug:
                  type: string
                  description: Canonical line-of-business slug
                  e.g. commercial_general_liability: null
                enabled:
                  type: boolean
      responses:
        '200':
          description: The refreshed market-access table
        '403':
          description: Admin role required
        '404':
          description: Line not listed by this program
          or program not visible: null
    servers:
    - url: https://api.hedgespecialty.com/api/v1
      description: Production
    - url: https://staging-api.hedgespecialty.com/api/v1
      description: Staging sandbox
  /broker/market-connections:
    get:
      tags:
      - Market access
      operationId: listMarketConnections
      summary: Your brokerage's own carrier appointments connected to Hedge
      description: 'Bring-your-own appointments (today: Next Insurance). Quotes for your

        submissions then run on your own account with that carrier.

        Requires `broker_submit`.'
      responses:
        '200':
          description: Rows of {provider_key, provider_name, status, label, allowed_states, last_validated_at, last_error}
    servers:
    - url: https://api.hedgespecialty.com/api/v1
      description: Production
    - url: https://staging-api.hedgespecialty.com/api/v1
      description: Staging sandbox
  /broker/market-connections/next-insurance:
    put:
      tags:
      - Market access
      operationId: connectNextInsurance
      summary: Connect your Next Insurance appointment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - referral_url
              properties:
                referral_url:
                  type: string
                  description: Your Next referral / client-binds-on-their-own link.
      responses:
        '200':
          description: The connection row
        '422':
          description: The link could not be validated
    delete:
      tags:
      - Market access
      operationId: disconnectNextInsurance
      summary: Disconnect your Next Insurance appointment
      responses:
        '204':
          description: Disconnected
    servers:
    - url: https://api.hedgespecialty.com/api/v1
      description: Production
    - url: https://staging-api.hedgespecialty.com/api/v1
      description: Staging sandbox
components:
  securitySchemes:
    brokerOAuth:
      type: oauth2
      description: 'Broker access token. Scopes: `broker_mcp` (read), `broker_submit`

        (write). Per-user tokens come from the OAuth authorization-code +

        PKCE flow (`/oauth/authorize` → `/oauth/token`); machine tokens

        from `client_credentials`, using an API key created self-serve in

        the broker portal (Settings → API keys) or issued by Hedge ops.

        Access tokens live 60 minutes.

        '
      flows:
        authorizationCode:
          authorizationUrl: https://api.hedgespecialty.com/api/v1/oauth/authorize
          tokenUrl: https://api.hedgespecialty.com/api/v1/oauth/token
          scopes:
            broker_mcp: Read brokerage-scoped submissions, policies, payments, appetite, and requirements.
            broker_submit: Create submissions, answer Hedge's asks, and act on quotes for your brokerage.
        clientCredentials:
          tokenUrl: https://api.hedgespecialty.com/api/v1/oauth/token
          scopes:
            broker_mcp: Read brokerage-scoped submissions, policies, payments, appetite, and requirements.
            broker_submit: Create submissions, answer Hedge's asks, and act on quotes for your brokerage.
externalDocs:
  description: Hedge developer documentation
  url: https://docs.hedgespecialty.com
x-refined-from:
- hedge-openapi.json
- hedgespecialty-com-openapi.yml