Hive Civilization Insurance API

The insurance API from Hive Civilization — 9 operation(s) for insurance.

Documentation GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/law/insurance/template/list List insurance arbitration templates · List Insurance Arbitration #

Ask an LLM

“What insurance arbitration templates are available in HiveLaw?”

“Can I pass metadata to narrow the arbitration template list?”

Tell an agent

List the insurance arbitration templates.

List insurance arbitration templates with metadata {metadata}.

GET /v1/law/insurance/agents List insurance arbitration agents · Get Agents #

Ask an LLM

“Which agents take part in insurance dispute arbitration?”

“Who are the insurance arbitration agents available?”

Tell an agent

List the insurance arbitration agents.

Show the agents that handle insurance disputes.

GET /v1/law/insurance/template Get the insurance contract template · Get Insurance Template #

Ask an LLM

“What fields does an insurance contract template require?”

“Where can I see the default insurance contract template?”

Tell an agent

Get the insurance contract template.

Show me the default insurance template shape.

POST /v1/law/insurance/contract Create an insurance claim contract · Post Insurance Contract #

Ask an LLM

“How do I set up an insurance contract with policy, claim and insurer bond details?”

“Can I add a reinsurer or repair vendor to an insurance contract?”

Tell an agent

Create a {lob} contract for policy {policy}: insured {insured}, insurer {insurer}, adjuster {adjuster}, in {country} {region}.

Open {claim_type} claim {claim} from {date} for {amount} USDC, limit {limit}, deductible {deductible}, bond {bond}.

GET /v1/law/insurance/contract/{contract_id} Get an insurance contract's details · Get Insurance Contract Detail #

Ask an LLM

“What are the terms and claim details of an insurance contract I created?”

“Can I look up an insurance contract by its id?”

Tell an agent

Get insurance contract {contract_id}.

Show the details of insurance contract {contract_id}.

POST /v1/law/insurance/dispute File an insurance claim dispute · Post Insurance Dispute #

Ask an LLM

“How do I dispute an adjuster's denial or lowball offer on a claim?”

“Can I attach evidence when filing an insurance dispute?”

Tell an agent

File a dispute on insurance contract {contract_id} as {filer_did}.

Dispute contract {contract_id} as {filer_did}: adjuster offered {adjuster_proposed_usdc} USDC, evidence {evidence}.

POST /v1/law/insurance/webhook Send an insurance exception event via webhook · Post Insurance Webhook #

Ask an LLM

“Can an MGA push insurance exception events and have them resolved as disputes automatically?”

“What payload shape does the insurance exception webhook accept?”

Tell an agent

Send this insurance exception event to the HiveLaw webhook.

Post a carrier exception event so it is filed and resolved as a dispute.

GET /v1/law/insurance/dispute/{dispute_id} Get an insurance dispute's outcome · Get Insurance Dispute #

Ask an LLM

“How was my insurance dispute resolved?”

“Can I check the status of a dispute by its id?”

Tell an agent

Get insurance dispute {dispute_id}.

Show the resolution of dispute {dispute_id}.

GET /v1/law/insurance/economics Get insurance arbitration economics · Insurance Economics #

Ask an LLM

“What fees and economics apply to insurance arbitration?”

“How much does HiveLaw insurance dispute resolution cost?”

Tell an agent

Show the insurance arbitration economics.

Get fee details for insurance disputes.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/thehiveryiq-com:thehiveryiq-com-insurance-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: HiveMorph v0.1 Insurance API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: Insurance
paths:
  /v1/law/insurance/template/list:
    post:
      tags:
      - Insurance
      summary: List Insurance Arbitration
      operationId: list_insurance_arbitration_v1_law_insurance_template_list_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response List Insurance Arbitration V1 Law Insurance Template List Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/insurance/agents:
    get:
      tags:
      - Insurance
      summary: Get Agents
      operationId: get_agents_v1_law_insurance_agents_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Agents V1 Law Insurance Agents Get
  /v1/law/insurance/template:
    get:
      tags:
      - Insurance
      summary: Get Insurance Template
      operationId: get_insurance_template_v1_law_insurance_template_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Insurance Template V1 Law Insurance Template Get
  /v1/law/insurance/contract:
    post:
      tags:
      - Insurance
      summary: Post Insurance Contract
      operationId: post_insurance_contract_v1_law_insurance_contract_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_law__insurance_routes__ContractBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Insurance Contract V1 Law Insurance Contract Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/insurance/contract/{contract_id}:
    get:
      tags:
      - Insurance
      summary: Get Insurance Contract Detail
      operationId: get_insurance_contract_detail_v1_law_insurance_contract__contract_id__get
      parameters:
      - name: contract_id
        in: path
        required: true
        schema:
          type: string
          title: Contract Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Insurance Contract Detail V1 Law Insurance Contract  Contract Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/insurance/dispute:
    post:
      tags:
      - Insurance
      summary: Post Insurance Dispute
      operationId: post_insurance_dispute_v1_law_insurance_dispute_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_law__insurance_routes__DisputeBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Insurance Dispute V1 Law Insurance Dispute Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/insurance/webhook:
    post:
      tags:
      - Insurance
      summary: Post Insurance Webhook
      description: 'Public webhook for MGA / non-admitted-carrier insurance exception

        events. Accepts the canonical exception-event shape (see

        insurance_webhook.py). Cytora Autopilot and CoverGo Claims payload

        shapes are accepted as schema-compatible test targets — those

        vendors are NOT integration partners (R3 council). Translates the

        payload into a HiveLaw insurance dispute filing and resolves it

        inline. Every outcome carries `requires_human_review` per Florida

        HB 527 / NAIC Model Bulletin / EU AI Act high-risk requirements.'
      operationId: post_insurance_webhook_v1_law_insurance_webhook_post
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: true
              type: object
              title: Payload
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Insurance Webhook V1 Law Insurance Webhook Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/insurance/dispute/{dispute_id}:
    get:
      tags:
      - Insurance
      summary: Get Insurance Dispute
      operationId: get_insurance_dispute_v1_law_insurance_dispute__dispute_id__get
      parameters:
      - name: dispute_id
        in: path
        required: true
        schema:
          type: string
          title: Dispute Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Insurance Dispute V1 Law Insurance Dispute  Dispute Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/insurance/economics:
    get:
      tags:
      - Insurance
      summary: Insurance Economics
      operationId: insurance_economics_v1_law_insurance_economics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Insurance Economics V1 Law Insurance Economics Get
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    hivemorph__hive_law__insurance_routes__ContractBody:
      properties:
        insured_did:
          type: string
          title: Insured Did
        insurer_did:
          type: string
          title: Insurer Did
        claims_adjuster_agent_did:
          type: string
          title: Claims Adjuster Agent Did
        reinsurer_did:
          type: string
          title: Reinsurer Did
          default: ''
        repair_vendor_did:
          type: string
          title: Repair Vendor Did
          default: ''
        country_iso:
          type: string
          maxLength: 2
          minLength: 2
          title: Country Iso
        region:
          type: string
          title: Region
        regulatory_regime:
          type: string
          title: Regulatory Regime
          default: ''
        policy_id:
          type: string
          title: Policy Id
        line_of_business:
          type: string
          title: Line Of Business
        coverage_limit_usdc:
          type: number
          exclusiveMinimum: 0.0
          title: Coverage Limit Usdc
        deductible_usdc:
          type: number
          minimum: 0.0
          title: Deductible Usdc
        exclusions:
          items:
            type: string
          type: array
          title: Exclusions
        effective_at:
          type: number
          title: Effective At
          default: 0.0
        expires_at:
          type: number
          title: Expires At
          default: 0.0
        claim_id:
          type: string
          title: Claim Id
        claim_type:
          type: string
          title: Claim Type
        incident_date:
          type: number
          title: Incident Date
        claimed_amount_usdc:
          type: number
          exclusiveMinimum: 0.0
          title: Claimed Amount Usdc
        evidence_refs:
          items:
            type: string
          type: array
          title: Evidence Refs
        description:
          type: string
          title: Description
          default: ''
        insurer_bond_usdc:
          type: number
          exclusiveMinimum: 0.0
          title: Insurer Bond Usdc
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - insured_did
      - insurer_did
      - claims_adjuster_agent_did
      - country_iso
      - region
      - policy_id
      - line_of_business
      - coverage_limit_usdc
      - deductible_usdc
      - claim_id
      - claim_type
      - incident_date
      - claimed_amount_usdc
      - insurer_bond_usdc
      title: ContractBody
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ListBody:
      properties:
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      title: ListBody
    hivemorph__hive_law__insurance_routes__DisputeBody:
      properties:
        dispute_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Dispute Id
        contract_id:
          type: string
          title: Contract Id
        filer_did:
          type: string
          title: Filer Did
        adjuster_proposed_usdc:
          type: number
          title: Adjuster Proposed Usdc
          default: 0.0
        adjuster_denied:
          type: boolean
          title: Adjuster Denied
          default: false
        denial_reason_claimed:
          type: string
          title: Denial Reason Claimed
          default: ''
        evidence:
          additionalProperties: true
          type: object
          title: Evidence
      type: object
      required:
      - contract_id
      - filer_did
      title: DisputeBody
x-provenance:
  method: harvested
  publisher: Hive Civilization
  source: https://receipts.thehiveryiq.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)

Hive Civilization Insurance API

Operations 9

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification