HumanMirror

HumanMirror Physical Oracle API

The Physical Oracle API from HumanMirror — 10 operation(s) for physical oracle.

Documentation GitHub OpenAPI

Operations 11

GET /api/physical-oracle/ Discover Physical Oracle #

POST /api/physical-oracle/quote/ Quote a public physical verification mission #

POST /api/physical-oracle/missions/ Create a mission #

GET /api/physical-oracle/missions/ Read buyer mission state #

POST /api/physical-oracle/workers/register/ Register a field executor #

GET /api/physical-oracle/workers/snapshot/ List compatible missions for a field executor #

POST /api/physical-oracle/claim/ Claim one mission for 20 minutes #

POST /api/physical-oracle/submit/ Submit bounded photo evidence #

POST /api/physical-oracle/verify/ Buyer accepts or rejects submitted evidence #

POST /api/physical-oracle/commission/ Pay accepted-mission HumanMirror commission over x402 #

POST /api/physical-oracle/payout-confirm/ Verify direct Base USDC payout to field executor #

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/humanmirror-fr:humanmirror-fr-physical-oracle-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: HumanMirror Physical Oracle API
  version: 1.0.0-beta
  description: Non-custodial A2H field verification for autonomous agents and businesses.
servers:
- url: https://humanmirror.fr
tags:
- name: Physical Oracle
paths:
  /api/physical-oracle/:
    get:
      summary: Discover Physical Oracle
      responses:
        '200':
          description: Discovery
      tags:
      - Physical Oracle
      operationId: getApiPhysicalOracle
      x-operation-id-source: derived
  /api/physical-oracle/quote/:
    post:
      summary: Quote a public physical verification mission
      responses:
        '200':
          description: Quote and observed field supply
        '422':
          description: Unsafe or invalid mission
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOracleQuote
      x-operation-id-source: derived
  /api/physical-oracle/missions/:
    post:
      summary: Create a mission
      responses:
        '201':
          description: Mission created; buyer key returned once
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOracleMissions
      x-operation-id-source: derived
    get:
      summary: Read buyer mission state
      responses:
        '200':
          description: Mission state
      tags:
      - Physical Oracle
      operationId: getApiPhysicalOracleMissions
      x-operation-id-source: derived
  /api/physical-oracle/workers/register/:
    post:
      summary: Register a field executor
      responses:
        '201':
          description: Field key returned once
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOracleWorkersRegister
      x-operation-id-source: derived
  /api/physical-oracle/workers/snapshot/:
    get:
      summary: List compatible missions for a field executor
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Worker profile and missions
      tags:
      - Physical Oracle
      operationId: getApiPhysicalOracleWorkersSnapshot
      x-operation-id-source: derived
  /api/physical-oracle/claim/:
    post:
      summary: Claim one mission for 20 minutes
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Mission and one-time claim nonce
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOracleClaim
      x-operation-id-source: derived
  /api/physical-oracle/submit/:
    post:
      summary: Submit bounded photo evidence
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Proof submitted
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOracleSubmit
      x-operation-id-source: derived
  /api/physical-oracle/verify/:
    post:
      summary: Buyer accepts or rejects submitted evidence
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Decision and signed physical receipt
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOracleVerify
      x-operation-id-source: derived
  /api/physical-oracle/commission/:
    post:
      summary: Pay accepted-mission HumanMirror commission over x402
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Commission settled
        '402':
          description: x402 payment required
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOracleCommission
      x-operation-id-source: derived
  /api/physical-oracle/payout-confirm/:
    post:
      summary: Verify direct Base USDC payout to field executor
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Mission settled
      tags:
      - Physical Oracle
      operationId: postApiPhysicalOraclePayoutConfirm
      x-operation-id-source: derived
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
x-humanmirror:
  protocol: humanmirror-physical-oracle/1
  custody: non_custodial
  worker_percent: 80
  platform_percent: 20
  network: eip155:8453
  asset: USDC

HumanMirror Physical Oracle API

Operations 11

Documentation

Specifications

Schemas & Data

Other Resources