Hive Civilization Governance API

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

Documentation GitHub OpenAPI

Operations 10

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

GET /v1/governance/health Check governance service health and signer · Health #

Ask an LLM

“Is the AI governance receipt service up?”

“Which signing key fingerprint is the governance service using for samples?”

Tell an agent

Check governance service health.

Get the governance sample-signer fingerprint.

GET /v1/governance/sample-receipt View a static example AI-use receipt · Public sample Ed25519-signed AI-use receipt #

Ask an LLM

“What does an Ed25519-signed AI-use receipt look like?”

“Is there a free reference example of the receipt governance pilots get?”

Tell an agent

Show me the static example AI-use receipt.

Fetch the public reference receipt shape without signing anything new.

POST /v1/governance/sample-receipt Issue a signed sample receipt for a use case · Post Sample Receipt #

Ask an LLM

“How do I generate a signed AI-use receipt for my own use case?”

“Can the sample receipt include my model family and routing policy?”

Tell an agent

Issue a signed sample receipt for use case {use_case}.

Generate a sample receipt for {use_case} at {enterprise_label} using model family {model_family}.

GET /v1/governance/sample-receipt/{receipt_id}.pdf Download a sample receipt as PDF · Get Sample Pdf #

Ask an LLM

“Can I download a sample governance receipt as a PDF?”

“How do I get a printable version of a sample receipt?”

Tell an agent

Download sample receipt {receipt_id} as a PDF.

Get the PDF rendering of receipt {receipt_id}.

GET /v1/governance/sample-receipt/{receipt_id}.json Get a sample receipt as JSON · Get Sample Json #

Ask an LLM

“How do I fetch a sample receipt I generated in machine-readable JSON?”

“Where is the raw JSON of a sample governance receipt?”

Tell an agent

Get sample receipt {receipt_id} as JSON.

Fetch the JSON for receipt {receipt_id}.

POST /v1/governance/lead Submit interest in the governance pilot · Post Lead #

Ask an LLM

“How do I sign up for the AI governance pilot?”

“Can I leave my company and use case to be contacted about governance receipts?”

Tell an agent

Register {email} from {company} for the governance pilot.

Submit a governance pilot lead for {company} with use case {use_case}.

GET /v1/governance/leads List recent governance pilot leads (admin) · Get Leads #

Ask an LLM

“Who has signed up for the governance pilot recently?”

“Can an admin pull the full list of pilot leads with contact details?”

Tell an agent

List the most recent governance leads.

Show the last {limit} governance pilot sign-ups.

GET /v1/governance/leads/summary Get aggregate governance lead counts · Free aggregate lead counts (no PII) #

Ask an LLM

“How many governance pilot leads have come in, without seeing personal details?”

“Is there a free summary count of pilot sign-ups?”

Tell an agent

Give me the aggregate governance lead counts.

Summarize pilot sign-ups without any PII.

GET /v1/governance/leads/health Check the governance leads log health · Get Leads Health #

Ask an LLM

“Is the governance leads log writable and alive?”

“Can I check the leads log without an admin token?”

Tell an agent

Check the health of the governance leads log under /v1/governance.

Ping the versioned leads log liveness endpoint.

GET /leads/health Probe the top-level lead pipeline health · Lead-pipeline health probe #

Ask an LLM

“Is the top-level lead-capture pipeline healthy?”

“Is there an unversioned health probe for lead capture?”

Tell an agent

Probe the top-level /leads/health endpoint.

Check the unversioned lead-capture pipeline health.

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-governance-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 Governance API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: Governance
paths:
  /v1/governance/health:
    get:
      tags:
      - Governance
      summary: Health
      description: Liveness + sample-signer fingerprint.
      operationId: health_v1_governance_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Governance Health Get
  /v1/governance/sample-receipt:
    get:
      tags:
      - Governance
      summary: Public sample Ed25519-signed AI-use receipt
      description: 'Free public sample of the AI-use receipt shape governance pilots receive.

        This is a static reference example — not a live signing event.

        Use POST /v1/governance/lead and the pilot enrollment to receive real receipts.'
      operationId: get_sample_receipt_example_v1_governance_sample_receipt_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Sample Receipt Example V1 Governance Sample Receipt Get
    post:
      tags:
      - Governance
      summary: Post Sample Receipt
      description: Issue a signed sample receipt for the supplied AI use case.
      operationId: post_sample_receipt_v1_governance_sample_receipt_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SampleReceiptBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SampleReceiptResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governance/sample-receipt/{receipt_id}.pdf:
    get:
      tags:
      - Governance
      summary: Get Sample Pdf
      operationId: get_sample_pdf_v1_governance_sample_receipt__receipt_id__pdf_get
      parameters:
      - name: receipt_id
        in: path
        required: true
        schema:
          type: string
          minLength: 64
          maxLength: 64
          pattern: ^[a-f0-9]{64}$
          title: Receipt Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governance/sample-receipt/{receipt_id}.json:
    get:
      tags:
      - Governance
      summary: Get Sample Json
      operationId: get_sample_json_v1_governance_sample_receipt__receipt_id__json_get
      parameters:
      - name: receipt_id
        in: path
        required: true
        schema:
          type: string
          minLength: 64
          maxLength: 64
          pattern: ^[a-f0-9]{64}$
          title: Receipt Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Sample Json V1 Governance Sample Receipt  Receipt Id  Json Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governance/lead:
    post:
      tags:
      - Governance
      summary: Post Lead
      description: 'Capture a governance pilot lead. Accepts optional email + company + use-case.

        Always 200 — never blocks the form. Persisted to JSONL on /var/data.'
      operationId: post_lead_v1_governance_lead_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LeadBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Lead V1 Governance Lead Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governance/leads:
    get:
      tags:
      - Governance
      summary: Get Leads
      description: 'Token-gated read of recent governance leads.

        Auth: query ?token=... or header X-Admin-Token, compared against ADMIN_TOKEN env.'
      operationId: get_leads_v1_governance_leads_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 200
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Leads V1 Governance Leads Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governance/leads/summary:
    get:
      tags:
      - Governance
      summary: Free aggregate lead counts (no PII)
      description: 'Free aggregate counts of governance pilot leads.

        No PII. For sensitive list, use authenticated GET /v1/governance/leads.'
      operationId: get_leads_summary_v1_governance_leads_summary_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Leads Summary V1 Governance Leads Summary Get
  /v1/governance/leads/health:
    get:
      tags:
      - Governance
      summary: Get Leads Health
      description: Liveness for the leads log. Does not require auth.
      operationId: get_leads_health_v1_governance_leads_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Leads Health V1 Governance Leads Health Get
  /leads/health:
    get:
      tags:
      - Governance
      summary: Lead-pipeline health probe
      description: Free top-level health probe for the governance lead-capture pipeline.
      operationId: leads_health_leads_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Leads Health Leads Health Get
components:
  schemas:
    SampleReceiptResponse:
      properties:
        receipt_id:
          type: string
          title: Receipt Id
        issued_at:
          type: string
          title: Issued At
        use_case_hash:
          type: string
          title: Use Case Hash
        signer_label:
          type: string
          title: Signer Label
        signer_pubkey:
          type: string
          title: Signer Pubkey
        signature_b64:
          type: string
          title: Signature B64
        anchor_chain:
          type: string
          title: Anchor Chain
        anchor_chain_id:
          type: integer
          title: Anchor Chain Id
        anchor_tx_hash:
          type: string
          title: Anchor Tx Hash
        anchor_status:
          type: string
          title: Anchor Status
        anchor_url:
          type: string
          title: Anchor Url
        pdf_url:
          type: string
          title: Pdf Url
        json_url:
          type: string
          title: Json Url
        sample_notice:
          anyOf:
          - type: string
          - type: 'null'
          title: Sample Notice
      type: object
      required:
      - receipt_id
      - issued_at
      - use_case_hash
      - signer_label
      - signer_pubkey
      - signature_b64
      - anchor_chain
      - anchor_chain_id
      - anchor_tx_hash
      - anchor_status
      - anchor_url
      - pdf_url
      - json_url
      title: SampleReceiptResponse
    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
    SampleReceiptBody:
      properties:
        use_case:
          type: string
          maxLength: 4000
          minLength: 8
          title: Use Case
          description: Describe the AI use case (e.g. 'GPT-4o reviews vendor NDAs and drafts redlines for Legal review').
        enterprise_label:
          anyOf:
          - type: string
            maxLength: 120
          - type: 'null'
          title: Enterprise Label
          description: How your company shows up on the receipt. Defaults to 'Sample Enterprise'.
        model_family:
          anyOf:
          - type: string
            maxLength: 80
          - type: 'null'
          title: Model Family
          description: Which model family. Defaults to 'vendor-llm/unspecified'.
        routing_policy:
          anyOf:
          - type: string
            maxLength: 80
          - type: 'null'
          title: Routing Policy
          description: Routing/policy name. Defaults to 'default-strict'.
      type: object
      required:
      - use_case
      title: SampleReceiptBody
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    LeadBody:
      properties:
        email:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Email
        company:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Company
        use_case:
          anyOf:
          - type: string
            maxLength: 4000
          - type: 'null'
          title: Use Case
        enterprise_label:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Enterprise Label
        model_family:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Model Family
        source:
          anyOf:
          - type: string
            maxLength: 120
          - type: 'null'
          title: Source
        path:
          anyOf:
          - type: string
            maxLength: 300
          - type: 'null'
          title: Path
        ref:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Ref
      type: object
      title: LeadBody
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 Governance API

Operations 10

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification