Hive Civilization

Hive Civilization Provebirth API

The provebirth API from Hive Civilization — 10 operation(s) for provebirth.

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/provebirth/health Check ProveBirth service health · Health #
Ask an LLM
“Is the ProveBirth agent certificate service up?”
“How do I health-check the birth certificate API?”
Tell an agent
Check ProveBirth health.
Ping the agent birth certificate service.
GET /v1/provebirth/pricing Get ProveBirth pricing · Pricing #
Ask an LLM
“How much does it cost to issue an agent birth certificate?”
“What does the Cosmic tier cost compared to standard pricing?”
Tell an agent
Show ProveBirth pricing.
List the prices for certificates and action attestations.
POST /v1/provebirth/cert/issue Issue a birth certificate for an AI agent · Cert Issue #
Ask an LLM
“How do I issue a birth certificate that pins an agent's model and tool grants?”
“What do I need to provide to certify a newly deployed AI agent?”
Tell an agent
Issue a birth certificate for agent {agent_did} under controller {controller_did} running model {model_pin} on {deployment_target}.
Certify agent {agent_did} with tool grants {tool_grants}, policy hash {policy_hash} and training cut-off {training_cut}.
GET /v1/provebirth/cert/{cert_id} Retrieve an agent birth certificate · Cert Get #
Ask an LLM
“How do I look up an agent birth certificate by its ID?”
“Which model and tool grants were recorded on a certificate?”
Tell an agent
Get birth certificate {cert_id}.
Show what certificate {cert_id} says about the agent.
POST /v1/provebirth/cert/verify Verify the signatures on a birth certificate · Cert Verify #
Ask an LLM
“Are the signatures on this agent birth certificate valid?”
“How can I prove a certificate hasn't been tampered with?”
Tell an agent
Verify the signatures on certificate {cert_id}.
Check that birth certificate {cert_id} is authentic.
POST /v1/provebirth/action/attest Attest an action taken by a certified agent · Action Attest #
Ask an LLM
“How do I record a tool call or payment an agent made, chained to its birth certificate?”
“Can I link each agent action to the one before it?”
Tell an agent
Attest a {action_type} action by {agent_did} under certificate {birth_cert_id} with hash {action_hash}.
Record {agent_did}'s {action_type} (hash {action_hash}, cert {birth_cert_id}) following action {prior_action_id}.
POST /v1/provebirth/lineage/verify Verify an agent's action lineage · Lineage Verify #
Ask an LLM
“Is an agent's whole chain of actions traceable back to its birth certificate?”
“Can I anchor lineage verification to a specific certificate instead of the latest?”
Tell an agent
Verify the lineage of agent {agent_did}.
Verify {agent_did}'s action chain anchored at certificate {cert_id}.
GET /v1/provebirth/by-agent/{agent_did} List certificates for an agent · By Agent #
Ask an LLM
“Which birth certificates have been issued to a particular agent?”
“How do I page through an agent's certificate history?”
Tell an agent
List birth certificates for agent {agent_did}.
Show {limit} certificates for agent {agent_did} starting at {offset}.
GET /v1/provebirth/by-controller/{controller_did} List certificates issued under a controller · By Controller #
Ask an LLM
“Which agents has my organization certified as their controller?”
“Can I list all birth certificates tied to one controller DID?”
Tell an agent
List certificates for controller {controller_did}.
Show the first {limit} agents certified by controller {controller_did}.
GET /v1/provebirth/by-model/{model_pin} List certificates for a pinned model · By Model #
Ask an LLM
“Which certified agents run on a specific pinned model version?”
“How many agents were born on a given model pin?”
Tell an agent
List birth certificates pinned to model {model_pin}.
Show {limit} agents running model {model_pin}.

Documentation

📖
Documentation
https://thehiveryiq.com/developers
📖
APIReference
https://receipts.thehiveryiq.com/docs
📖
GettingStarted
https://thehiveryiq.com/agents
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/authentication/thehiveryiq-com-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/rate-limits/thehiveryiq-com-rate-limits.yml
📖
Documentation
https://thehiveryiq.com/sdk-quickstart/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/openapi/thehiveryiq-com-provebirth-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-receipts-llms.txt
🔗
LLMsTxt
https://receipts.thehiveryiq.com/llms.txt
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/data-model/thehiveryiq-com-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/asyncapi/thehiveryiq-com-webhooks.yml
🔗
StatusPage
https://receipts.thehiveryiq.com/status
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/errors/thehiveryiq-com-problem-types.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/sandbox/thehiveryiq-com-sandbox.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-hivecompute-llms.txt
🔗
LLMsTxt
https://api.thehiveryiq.com/llms.txt
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/mcp/thehiveryiq-com-tool-crosswalk.yml

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-provebirth-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

thehiveryiq-com-provebirth-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Provebirth API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: provebirth
paths:
  /v1/provebirth/health:
    get:
      tags:
      - provebirth
      summary: Health
      operationId: health_v1_provebirth_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Provebirth Health Get
  /v1/provebirth/pricing:
    get:
      tags:
      - provebirth
      summary: Pricing
      operationId: pricing_v1_provebirth_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Pricing V1 Provebirth Pricing Get
  /v1/provebirth/cert/issue:
    post:
      tags:
      - provebirth
      summary: Cert Issue
      operationId: cert_issue_v1_provebirth_cert_issue_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BirthCertIssueRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BirthCertIssueResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/provebirth/cert/{cert_id}:
    get:
      tags:
      - provebirth
      summary: Cert Get
      operationId: cert_get_v1_provebirth_cert__cert_id__get
      parameters:
      - name: cert_id
        in: path
        required: true
        schema:
          type: string
          title: Cert Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Cert Get V1 Provebirth Cert  Cert Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/provebirth/cert/verify:
    post:
      tags:
      - provebirth
      summary: Cert Verify
      operationId: cert_verify_v1_provebirth_cert_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BirthCertVerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BirthCertVerifyResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/provebirth/action/attest:
    post:
      tags:
      - provebirth
      summary: Action Attest
      operationId: action_attest_v1_provebirth_action_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ActionAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionAttestResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/provebirth/lineage/verify:
    post:
      tags:
      - provebirth
      summary: Lineage Verify
      operationId: lineage_verify_v1_provebirth_lineage_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LineageVerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LineageVerifyResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/provebirth/by-agent/{agent_did}:
    get:
      tags:
      - provebirth
      summary: By Agent
      operationId: by_agent_v1_provebirth_by_agent__agent_did__get
      parameters:
      - name: agent_did
        in: path
        required: true
        schema:
          type: string
          title: Agent Did
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response By Agent V1 Provebirth By Agent  Agent Did  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/provebirth/by-controller/{controller_did}:
    get:
      tags:
      - provebirth
      summary: By Controller
      operationId: by_controller_v1_provebirth_by_controller__controller_did__get
      parameters:
      - name: controller_did
        in: path
        required: true
        schema:
          type: string
          title: Controller Did
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response By Controller V1 Provebirth By Controller  Controller Did  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/provebirth/by-model/{model_pin}:
    get:
      tags:
      - provebirth
      summary: By Model
      operationId: by_model_v1_provebirth_by_model__model_pin__get
      parameters:
      - name: model_pin
        in: path
        required: true
        schema:
          type: string
          title: Model Pin
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response By Model V1 Provebirth By Model  Model Pin  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    LineageVerifyRequest:
      properties:
        agent_did:
          type: string
          title: Agent Did
          description: Agent DID to verify lineage for
        cert_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Cert Id
          description: Specific cert_id to anchor verification (uses latest if omitted)
      type: object
      required:
      - agent_did
      title: LineageVerifyRequest
      description: 'Verify the full chain for an agent: birth cert + all actions.'
    BirthCertIssueRequest:
      properties:
        agent_did:
          type: string
          title: Agent Did
          description: DID of the AI agent being born (did:hive:...)
        controller_did:
          type: string
          title: Controller Did
          description: DID of the human/org controller (did:hive:...)
        model_pin:
          type: string
          title: Model Pin
          description: Pinned model identifier, e.g. 'claude-3-5-sonnet@20241022', 'gpt-4o@2024-11-20'
        tool_grants:
          items:
            type: string
          type: array
          title: Tool Grants
          description: Granted tool scopes, e.g. ['fs.read', 'http.get', 'payments.x402']
        policy_hash:
          type: string
          maxLength: 64
          minLength: 64
          title: Policy Hash
          description: sha256 hex of the controller's policy document
        training_cut:
          type: string
          title: Training Cut
          description: ISO date of the model's training data cut-off, e.g. '2024-04-01'
        deployment_target:
          type: string
          title: Deployment Target
          description: 'Deployment framework: langchain, crewai, autogen, langgraph, mastra, custom'
        cosmic_tier:
          type: boolean
          title: Cosmic Tier
          description: Use Cosmic tier pricing
          default: false
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - agent_did
      - controller_did
      - model_pin
      - tool_grants
      - policy_hash
      - training_cut
      - deployment_target
      title: BirthCertIssueRequest
      description: Request to issue a dual-signed agent birth certificate.
    BirthCertIssueResponse:
      properties:
        cert_id:
          type: string
          title: Cert Id
        agent_did:
          type: string
          title: Agent Did
        controller_did:
          type: string
          title: Controller Did
        model_pin:
          type: string
          title: Model Pin
        tool_grants:
          items:
            type: string
          type: array
          title: Tool Grants
        policy_hash:
          type: string
          title: Policy Hash
        training_cut:
          type: string
          title: Training Cut
        deployment_target:
          type: string
          title: Deployment Target
        created_at:
          type: string
          title: Created At
        ed25519_signature:
          type: string
          title: Ed25519 Signature
        mldsa65_signature:
          type: string
          title: Mldsa65 Signature
        price_usd:
          type: number
          title: Price Usd
        receipt_envelope:
          additionalProperties: true
          type: object
          title: Receipt Envelope
        signatures:
          additionalProperties: true
          type: object
          title: Signatures
        notes:
          items:
            type: string
          type: array
          title: Notes
      type: object
      required:
      - cert_id
      - agent_did
      - controller_did
      - model_pin
      - tool_grants
      - policy_hash
      - training_cut
      - deployment_target
      - created_at
      - ed25519_signature
      - mldsa65_signature
      - price_usd
      - receipt_envelope
      title: BirthCertIssueResponse
    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
    LineageVerifyResponse:
      properties:
        agent_did:
          type: string
          title: Agent Did
        cert_id:
          type: string
          title: Cert Id
        chain_valid:
          type: boolean
          title: Chain Valid
        birth_cert_valid:
          type: boolean
          title: Birth Cert Valid
        action_count:
          type: integer
          title: Action Count
        discrepancies:
          items:
            type: string
          type: array
          title: Discrepancies
        chain:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Chain
      type: object
      required:
      - agent_did
      - cert_id
      - chain_valid
      - birth_cert_valid
      - action_count
      title: LineageVerifyResponse
    ActionAttestResponse:
      properties:
        action_id:
          type: string
          title: Action Id
        agent_did:
          type: string
          title: Agent Did
        birth_cert_id:
          type: string
          title: Birth Cert Id
        prior_action_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Prior Action Id
        action_type:
          type: string
          title: Action Type
        action_hash:
          type: string
          title: Action Hash
        created_at:
          type: string
          title: Created At
        ed25519_signature:
          type: string
          title: Ed25519 Signature
        mldsa65_signature:
          type: string
          title: Mldsa65 Signature
        price_usd:
          type: number
          title: Price Usd
        receipt_envelope:
          additionalProperties: true
          type: object
          title: Receipt Envelope
      type: object
      required:
      - action_id
      - agent_did
      - birth_cert_id
      - action_type
      - action_hash
      - created_at
      - ed25519_signature
      - mldsa65_signature
      - price_usd
      - receipt_envelope
      title: ActionAttestResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    BirthCertVerifyResponse:
      properties:
        cert_id:
          type: string
          title: Cert Id
        agent_did:
          type: string
          title: Agent Did
        controller_did:
          type: string
          title: Controller Did
        model_pin:
          type: string
          title: Model Pin
        created_at:
          type: string
          title: Created At
        receipt_envelope:
          additionalProperties: true
          type: object
          title: Receipt Envelope
        verification:
          additionalProperties: true
          type: object
          title: Verification
      type: object
      required:
      - cert_id
      - agent_did
      - controller_did
      - model_pin
      - created_at
      - receipt_envelope
      - verification
      title: BirthCertVerifyResponse
    ActionAttestRequest:
      properties:
        agent_did:
          type: string
          title: Agent Did
          description: DID of the acting agent
        birth_cert_id:
          type: string
          title: Birth Cert Id
          description: cert_id of the agent's birth certificate (chain pointer)
        prior_action_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Prior Action Id
          description: action_id of the immediately prior action (chain pointer, optional)
        action_type:
          type: string
          title: Action Type
          description: 'Action category: tool_call, payment, decision, output_emit'
        action_hash:
          type: string
          maxLength: 64
          minLength: 64
          title: Action Hash
          description: sha256 hex of the canonical action payload
        cosmic_tier:
          type: boolean
          title: Cosmic Tier
          description: Use Cosmic tier pricing
          default: false
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - agent_did
      - birth_cert_id
      - action_type
      - action_hash
      title: ActionAttestRequest
      description: Attest an agent action with a chain pointer back to its birth certificate.
    BirthCertVerifyRequest:
      properties:
        cert_id:
          type: string
          title: Cert Id
          description: The cert_id to verify signatures for
      type: object
      required:
      - cert_id
      title: BirthCertVerifyRequest
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)