Hive Civilization Law API

The law API from Hive Civilization — 18 operation(s) for law.

Business capability
Legal Management BC-150

Operations 18

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/freight/template/list List freight arbitration templates · List Freight Arbitration #
Ask an LLM
“Which freight arbitration templates are available to list?”
“Can I pull the full list of freight arbitration terms before drafting a shipping contract?”
Tell an agent
List the freight arbitration templates.
List freight arbitration templates, passing {metadata} with the request.
GET /v1/law/agents List the freight law agents · Get Agents #
Ask an LLM
“Which agents handle freight arbitration in the law service?”
“What agents sit behind the freight contract and dispute workflow?”
Tell an agent
Show me the agents that run freight arbitration.
List the freight law agents.
GET /v1/law/freight/template Get the freight contract template · Get Freight Template #
Ask an LLM
“What does the freight contract template look like before I file one?”
“What fields does the freight arbitration template expect for a shipment?”
Tell an agent
Fetch the freight contract template.
Show me the default freight arbitration template.
POST /v1/law/freight/contract Create a bonded freight contract · Post Freight Contract #
Ask an LLM
“How do I set up a freight contract between a shipper, broker, carrier and consignee?”
“Can a freight contract carry a USDC bond alongside the agreed rate?”
Tell an agent
Create a freight contract from {lane_origin} to {lane_dest} at {agreed_rate_usdc} USDC with a {bond_amount_usdc} USDC bond.
Open a freight contract between shipper {shipper_did} and carrier {carrier_did} via broker {broker_did} for consignee {consignee_did}.
GET /v1/law/freight/contract/{contract_id} Get a freight contract · Get Freight Contract #
Ask an LLM
“How can I look up the terms of a freight contract I already created?”
“Where do I see the parties and bond on an existing freight contract?”
Tell an agent
Show freight contract {contract_id}.
Pull up the details of freight contract {contract_id}.
POST /v1/law/freight/dispute File a dispute on a freight contract · Post Freight Dispute #
Ask an LLM
“How do I file a dispute against a freight contract when a shipment goes wrong?”
“Can I attach evidence when disputing a freight delivery?”
Tell an agent
File a freight dispute on contract {contract_id} for {dispute_condition}, filed by {filer_did}.
Dispute freight contract {contract_id} as {filer_did} with evidence {evidence}.
POST /v1/law/freight/webhook Send a freight exception event by webhook · Post Freight Webhook #
Ask an LLM
“Can I push freight exception events from Zapier or my ERP into the law service?”
“Where do broker freight exception webhooks get posted?”
Tell an agent
Post this freight exception event to the freight webhook.
Forward our shipment exception alert to the freight exception webhook.
GET /v1/law/freight/dispute/{dispute_id} Get a freight dispute · Get Freight Dispute #
Ask an LLM
“How do I check where a freight dispute stands?”
“What was decided on the freight dispute I filed?”
Tell an agent
Show freight dispute {dispute_id}.
Check the status of freight dispute {dispute_id}.
GET /v1/law/freight/economics View freight arbitration economics · Freight Economics #
Ask an LLM
“What are the economics of the freight arbitration service?”
“How much revenue does freight arbitration generate?”
Tell an agent
Show me the freight arbitration economics.
Report the freight dispute economics.
POST /v1/law/insurance/template/list List insurance arbitration templates · List Insurance Arbitration #
Ask an LLM
“Which insurance claim arbitration templates can I list?”
“Can I see every insurance arbitration template before opening a claim contract?”
Tell an agent
List the insurance arbitration templates.
List insurance arbitration templates, sending {metadata} with the call.
GET /v1/law/insurance/agents List the insurance law agents · Get Agents #
Ask an LLM
“Which agents run insurance claim arbitration?”
“What agents are involved in the insurance dispute workflow?”
Tell an agent
Show me the agents that handle insurance arbitration.
List the insurance law agents.
GET /v1/law/insurance/template Get the insurance claim contract template · Get Insurance Template #
Ask an LLM
“What does the insurance claim contract template contain?”
“What fields does an insurance arbitration contract need?”
Tell an agent
Fetch the insurance claim contract template.
Show me the default insurance arbitration template.
POST /v1/law/insurance/contract Create an insurance claim contract · Post Insurance Contract #
Ask an LLM
“How do I register an insurance claim for arbitration between insured and insurer?”
“Can I record a policy's coverage limit and deductible along with the claim?”
Tell an agent
Open an insurance claim contract for policy {policy_id}, claim {claim_id}, claiming {claimed_amount_usdc} USDC.
Create an insurance contract between insured {insured_did} and insurer {insurer_did} with adjuster {claims_adjuster_agent_did}.
GET /v1/law/insurance/contract/{contract_id} Get an insurance claim contract · Get Insurance Contract Detail #
Ask an LLM
“How can I review an insurance claim contract I already opened?”
“Where do I see the coverage and claim amount on an existing insurance contract?”
Tell an agent
Show insurance contract {contract_id}.
Pull up the details of insurance claim contract {contract_id}.
POST /v1/law/insurance/dispute Dispute an insurance claim decision · Post Insurance Dispute #
Ask an LLM
“How do I dispute a denied insurance claim?”
“Can I challenge the amount an adjuster proposed on my insurance claim?”
Tell an agent
Dispute insurance contract {contract_id} as {filer_did}.
Challenge the adjuster's {adjuster_proposed_usdc} USDC offer on insurance contract {contract_id} filed by {filer_did}.
POST /v1/law/insurance/webhook Send an insurance exception event by webhook · Post Insurance Webhook #
Ask an LLM
“Can an MGA push insurance claim exception events into the law service?”
“Where do insurance exception webhooks get posted?”
Tell an agent
Post this insurance exception event to the insurance webhook.
Forward our claims exception alert to the insurance exception webhook.
GET /v1/law/insurance/dispute/{dispute_id} Get an insurance dispute · Get Insurance Dispute #
Ask an LLM
“How do I check the outcome of an insurance claim dispute?”
“Where can I see the status of the insurance dispute I raised?”
Tell an agent
Show insurance dispute {dispute_id}.
Check the status of insurance dispute {dispute_id}.
GET /v1/law/insurance/economics View insurance arbitration economics · Insurance Economics #
Ask an LLM
“What are the economics of the insurance arbitration service?”
“How much revenue does insurance claim arbitration bring in?”
Tell an agent
Show me the insurance arbitration economics.
Report the insurance dispute economics.

Documentation

Specifications

Other Resources

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-law-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.

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

OpenAPI Specification

thehiveryiq-com-law-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Law API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: law
paths:
  /v1/law/freight/template/list:
    post:
      tags:
      - law
      summary: List Freight Arbitration
      operationId: list_freight_arbitration_v1_law_freight_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 Freight Arbitration V1 Law Freight Template List Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/agents:
    get:
      tags:
      - law
      summary: Get Agents
      operationId: get_agents_v1_law_agents_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Agents V1 Law Agents Get
  /v1/law/freight/template:
    get:
      tags:
      - law
      summary: Get Freight Template
      operationId: get_freight_template_v1_law_freight_template_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Freight Template V1 Law Freight Template Get
  /v1/law/freight/contract:
    post:
      tags:
      - law
      summary: Post Freight Contract
      operationId: post_freight_contract_v1_law_freight_contract_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_law__routes__ContractBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Freight Contract V1 Law Freight Contract Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/freight/contract/{contract_id}:
    get:
      tags:
      - law
      summary: Get Freight Contract
      operationId: get_freight_contract_v1_law_freight_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 Freight Contract V1 Law Freight Contract  Contract Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/freight/dispute:
    post:
      tags:
      - law
      summary: Post Freight Dispute
      operationId: post_freight_dispute_v1_law_freight_dispute_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_law__routes__DisputeBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Freight Dispute V1 Law Freight Dispute Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/freight/webhook:
    post:
      tags:
      - law
      summary: Post Freight Webhook
      description: 'Public webhook for SMB-broker freight exception events. Accepts the

        canonical exception-event shape (suitable for posting from webhook.site,

        Zapier, n8n, an in-house ERP, or any generic HTTP poster). Vendor-shaped

        payloads matching the project44 / C.H. Robinson / Hwy Haul schemas are

        also accepted as schema-compatible test targets — those vendors are NOT

        integration partners (R3 council: enterprise platforms are closed

        systems). Translates the payload into a HiveLaw dispute filing and

        resolves it inline.'
      operationId: post_freight_webhook_v1_law_freight_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 Freight Webhook V1 Law Freight Webhook Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/freight/dispute/{dispute_id}:
    get:
      tags:
      - law
      summary: Get Freight Dispute
      operationId: get_freight_dispute_v1_law_freight_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 Freight Dispute V1 Law Freight Dispute  Dispute Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/law/freight/economics:
    get:
      tags:
      - law
      summary: Freight Economics
      operationId: freight_economics_v1_law_freight_economics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Freight Economics V1 Law Freight Economics Get
  /v1/law/insurance/template/list:
    post:
      tags:
      - law
      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:
      - law
      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:
      - law
      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:
      - law
      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:
      - law
      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:
      - law
      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:
      - law
      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:
      - law
      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:
      - law
      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:
    hivemorph__hive_law__routes__ContractBody:
      properties:
        shipper_did:
          type: string
          title: Shipper Did
        broker_did:
          type: string
          title: Broker Did
        carrier_did:
          type: string
          title: Carrier Did
        consignee_did:
          type: string
          title: Consignee Did
        country_iso:
          type: string
          maxLength: 2
          minLength: 2
          title: Country Iso
        region:
          type: string
          title: Region
        lane_origin:
          type: string
          title: Lane Origin
        lane_dest:
          type: string
          title: Lane Dest
        pickup_window_start:
          type: number
          title: Pickup Window Start
        pickup_window_end:
          type: number
          title: Pickup Window End
        delivery_window_start:
          type: number
          title: Delivery Window Start
        delivery_window_end:
          type: number
          title: Delivery Window End
        freight_class:
          type: string
          title: Freight Class
        weight_lb:
          type: number
          exclusiveMinimum: 0.0
          title: Weight Lb
        dims_in:
          items:
            type: number
          type: array
          maxItems: 3
          minItems: 3
          title: Dims In
        declared_value_usd:
          type: number
          minimum: 0.0
          title: Declared Value Usd
        agreed_rate_usdc:
          type: number
          exclusiveMinimum: 0.0
          title: Agreed Rate Usdc
        bond_amount_usdc:
          type: number
          exclusiveMinimum: 0.0
          title: Bond Amount Usdc
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - shipper_did
      - broker_did
      - carrier_did
      - consignee_did
      - country_iso
      - region
      - lane_origin
      - lane_dest
      - pickup_window_start
      - pickup_window_end
      - delivery_window_start
      - delivery_window_end
      - freight_class
      - weight_lb
      - dims_in
      - declared_value_usd
      - agreed_rate_usdc
      - bond_amount_usdc
      title: ContractBody
    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__routes__DisputeBody:
      properties:
        dispute_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Dispute Id
        contract_id:
          type: string
          title: Contract Id
        dispute_condition:
          type: string
          title: Dispute Condition
        filer_did:
          type: string
          title: Filer Did
        evidence:
          additionalProperties: true
          type: object
          title: Evidence
      type: object
      required:
      - contract_id
      - dispute_condition
      - filer_did
      title: DisputeBody
    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)