gaipagents-com

gaipagents-com Evidence Ledger API

Receipts, verification, evidence packs, incident bundles and outcomes.

GitHub OpenAPI

Operations 15

GET /history.json Get history #
GET /receipts/{receipt_id} Get receipt #
POST /v1/free/commercial/outcome-value Evaluate outcome value #
POST /v1/free/disputes/evidence Capture symmetric dispute evidence #
POST /v1/free/evidence/freshness Check evidence freshness #
POST /v1/free/evidence/incident-bundle Incident bundle #
POST /v1/free/evidence/pack Evidence pack #
GET /v1/free/evidence/receipt-spec GAIP receipt specification #
GET /v1/free/member/history Member history #
GET /v1/free/member/usage Member usage #
GET /v1/free/receipts/transparency Get V1Free receipts transparency #
GET /v1/free/receipts/{receipt_id} Get V1Free receipts receipt id #
GET /v1/free/receipts/{receipt_id}/formats/{format} Export a receipt in another format #
GET /v1/free/receipts/{receipt_id}/verify Get V1Free receipts receipt id verify #
GET /v1/free/record-extract An extract of GAIP's record about a URL #

Documentation

📖
Documentation
https://www.gaipagents.com
📖
APIReference
https://www.gaipagents.com/openapi.json

Specifications

⚙
OpenAPI
https://artifacts.apis.io/gaipagents-com/openapi/gaipagents-com-evidence-ledger-api-openapi.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/gaipagents-com:gaipagents-com-evidence-ledger-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

gaipagents-com-evidence-ledger-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    name: GAIP
    url: https://www.gaipagents.com/contact
  description: 'GAIP, the Governed Agentic Intelligence Platform, keeps an independent, dated record of what AI agents, MCP servers and online shops publish, and answers questions about that record with signed receipts. Free, read-only, no key; facts at a stated time, never an assessment. First call: gaip_check on https://www.gaipagents.com/mcp, or GET https://www.gaipagents.com/v1/free/conformance/check?url=. What it answers, by who asks: https://www.gaipagents.com/v1/free/map. Every completed answer carries a continuity handle; send it back and the answer is bound to your own history with GAIP.'
  summary: GAIP keeps an independent, dated record of what AI agents, MCP servers and online shops publish.
  termsOfService: https://www.gaipagents.com/terms
  title: GAIP Evidence Ledger API
  version: 1.8.0
  x-gaip-legal:
    corrections: https://www.gaipagents.com/corrections
    methodology: https://www.gaipagents.com/methodology
    privacyPolicy: https://www.gaipagents.com/privacy
    status: DRAFT_PENDING_LEGAL_REVIEW
    termsOfService: https://www.gaipagents.com/terms
  x-gaip-manifest-version: 0.15.0
  x-gaip-platform-name: GAIP
servers:
- url: https://www.gaipagents.com
security: []
tags:
- description: Receipts, verification, evidence packs, incident bundles and outcomes.
  name: Evidence Ledger
paths:
  /history.json:
    get:
      description: GET /history.json
      operationId: getHistory
      responses:
        '200':
          description: Public evidence feed
      tags:
      - Evidence Ledger
      summary: Get history
      x-summary-source: derived
  /receipts/{receipt_id}:
    get:
      description: GET /receipts/{receipt_id}
      operationId: getReceipt
      parameters:
      - in: path
        name: receipt_id
        required: true
        schema:
          format: uuid
          type: string
      responses:
        '200':
          description: Receipt
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Not found
      tags:
      - Evidence Ledger
      summary: Get receipt
      x-summary-source: derived
  /v1/free/commercial/outcome-value:
    post:
      description: Produce a task outcome and cost dossier from caller-supplied public evidence; no independent verification or ROI claim.
      operationId: evaluateOutcomeValue
      requestBody:
        content:
          application/json:
            schema:
              required:
              - data_classification
              - counterparty_id
              - task_class
              - episode_id
              - task
              - delivery
              - costs
              type: object
        required: true
      responses:
        '200':
          description: Retained dossier
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Blocked
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: History unavailable
      tags:
      - Evidence Ledger
      summary: Evaluate outcome value
      x-summary-source: derived
  /v1/free/disputes/evidence:
    post:
      description: POST /v1/free/disputes/evidence
      operationId: captureSymmetricDisputeEvidence
      responses:
        '202':
          description: Quarantined unadjudicated evidence with equal response path
      tags:
      - Evidence Ledger
      summary: Capture symmetric dispute evidence
      x-summary-source: derived
  /v1/free/evidence/freshness:
    post:
      description: POST /v1/free/evidence/freshness
      operationId: checkEvidenceFreshness
      responses:
        '200':
          description: Freshness and re-verification states without deleting history
      tags:
      - Evidence Ledger
      summary: Check evidence freshness
      x-summary-source: derived
  /v1/free/evidence/incident-bundle:
    post:
      description: Put the receipts and attributed observations about an incident in time order.
      operationId: buildIncidentBundle
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          description: Incident bundle
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Invalid request
      summary: Incident bundle
      tags:
      - Evidence Ledger
  /v1/free/evidence/pack:
    post:
      description: Compile a subject's conformance, watch, witness and repair history into one dossier with a verify URL per item.
      externalDocs:
        url: https://www.gaipagents.com/docs/api#buildEvidencePack
      operationId: buildEvidencePack
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          description: Evidence pack
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Invalid request
      summary: Evidence pack
      tags:
      - Evidence Ledger
  /v1/free/evidence/receipt-spec:
    get:
      description: The receipt format and verification procedure (text/markdown).
      operationId: getReceiptSpec
      responses:
        '200':
          description: OK
      summary: GAIP receipt specification
      tags:
      - Evidence Ledger
  /v1/free/member/history:
    servers:
    - url: https://gaip-agent-to-art-prototype-production.up.railway.app
    get:
      description: Receipts linked to the caller's continuity handle.
      operationId: getMemberHistory
      parameters:
      - description: Continuity handle '<continuity_id>.<token>' returned with an earlier receipt.
        in: header
        name: X-GAIP-Continuity
        required: true
        schema:
          type: string
      responses:
        '200':
          description: History
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: No valid continuity handle
      summary: Member history
      tags:
      - Evidence Ledger
  /v1/free/member/usage:
    servers:
    - url: https://gaip-agent-to-art-prototype-production.up.railway.app
    get:
      description: Today's call counts for the caller's continuity handle.
      operationId: getMemberUsage
      parameters:
      - description: Continuity handle '<continuity_id>.<token>' returned with an earlier receipt.
        in: header
        name: X-GAIP-Continuity
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Usage
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: No valid continuity handle
      summary: Member usage
      tags:
      - Evidence Ledger
  /v1/free/receipts/transparency:
    get:
      description: Get the current GAIP history Merkle root and anchor status
      operationId: getV1FreeReceiptsTransparency
      responses:
        '200':
          description: Transparency snapshot
      tags:
      - Evidence Ledger
      summary: Get V1Free receipts transparency
      x-summary-source: derived
  /v1/free/receipts/{receipt_id}:
    get:
      description: Retrieve a durable execution receipt
      operationId: getV1FreeReceiptsReceiptId
      parameters:
      - in: path
        name: receipt_id
        required: true
        schema:
          format: uuid
          type: string
      responses:
        '200':
          description: Retained hash-chained observation
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Receipt not found
      tags:
      - Evidence Ledger
      summary: Get V1Free receipts receipt id
      x-summary-source: derived
  /v1/free/receipts/{receipt_id}/formats/{format}:
    get:
      description: Return a retained GAIP receipt in another ecosystem's shape, unsigned.
      operationId: exportReceipt
      parameters:
      - description: GAIP receipt id
        in: path
        name: receipt_id
        required: true
        schema:
          type: string
      - description: Target format, for example x402 or in-toto
        in: path
        name: format
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Exported receipt
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unknown format
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Receipt not found
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Rate limited
      summary: Export a receipt in another format
      tags:
      - Evidence Ledger
  /v1/free/receipts/{receipt_id}/verify:
    get:
      description: Verify a retained GAIP receipt, chain and Merkle inclusion proof
      operationId: getV1FreeReceiptsReceiptIdVerify
      parameters:
      - in: path
        name: receipt_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Machine-readable verification report
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Receipt not found
      tags:
      - Evidence Ledger
      summary: Get V1Free receipts receipt id verify
      x-summary-source: derived
  /v1/free/record-extract:
    get:
      description: GAIP's own recorded entries about an agent card, MCP endpoint or shop product page (Observatory change log and…
      externalDocs:
        url: https://www.gaipagents.com/docs/api#getRecordExtract
      operationId: getRecordExtract
      parameters:
      - description: Agent card, MCP endpoint or shop product page URL
        in: query
        name: url
        required: true
        schema:
          type: string
      - description: Start of the range (YYYY-MM-DD or RFC 3339)
        in: query
        name: since
        schema:
          type: string
      - description: End of the range (YYYY-MM-DD, inclusive, or RFC 3339)
        in: query
        name: until
        schema:
          type: string
      - description: Most entries (1-200, default 50)
        in: query
        name: limit
        schema:
          minimum: 1
          type: integer
      responses:
        '200':
          description: The signed extract (state EXTRACT, NO_RECORD or WITHDRAWN)
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Invalid input
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Rate limited
      summary: An extract of GAIP's record about a URL
      tags:
      - Evidence Ledger
components:
  schemas:
    Error:
      additionalProperties: true
      description: 'Error body returned by GAIP routes: a stable machine code plus optional detail.'
      properties:
        detail:
          description: Optional human-readable detail or structured context.
        error:
          description: Stable machine-readable error code, e.g. NOT_FOUND.
          type: string
        failure_class:
          description: Optional failure class for storage errors.
          type: string
      required:
      - error
      type: object
  requestBodies:
    JsonObject:
      content:
        application/json:
          schema:
            type: object
      required: true
externalDocs:
  description: Agent-readable guide
  url: https://www.gaipagents.com/llms.txt
x-gaip-internal-paths:
  description: Served but not part of the public API listing (operations, programme metrics, founder-only plans). No stability commitment.
  paths:
  - /a2a/buyer-assurance
  - /activation-pack.json
  - /erc8004/transaction-plan.json
  - /examples/art-claix-002.json
  - /examples/broker-claix-002.json
  - /integration.json
  - /measurement.json
  - /onboarding.json
  - /phase-entry.json
  - /phase1-acceleration.json
  - /phase1-exit.json
  - /phase1-outcome-receipt-schema.json
  - /phase1-receipt-verification.json
  - /phase1-receipts/preflight
  - /phase1-scorecard.json
  - /phase1-use-receipt-schema.json
  - /progress.json
  - /proof.json
  - /schemas/counterparty-evidence-request-v1.schema.json
  - /schemas/counterparty-evidence-response-v1.schema.json
  - /shared-result.json
  - /status.json
  - /v1/free/adoption/status
  - /v1/free/agents/buyer-assurance/operations
  - /v1/free/art/evaluate
  - /v1/free/broker/preflight
  - /v1/free/commercial/capabilities
  - /v1/free/commercial/coo-report
  - /v1/free/commercial/outcome-value/capabilities
  - /v1/free/counterparty-evidence
  - /v1/free/delegation-evidence
  - /v1/free/design-partner/qualify
  - /v1/free/digital-art/evidence-check
  - /v1/free/discovery/cohort
  - /v1/free/extended-preflight/capabilities
  - /v1/free/history/metrics
  - /v1/free/incubator/agent-output-assurance
  - /v1/free/interoperability/recovery
  - /v1/free/loop/run
  - /v1/free/outcomes/preflight
  - /v1/free/sales/inbound-reply
  - /v1/free/sales/outbound-policy
  - /v1/free/verify-before-call
  - /v1/shadow/services
  - /value-outputs.json
x-gaip-native-execution:
  automaticEvidenceCredit: false
  durableReceiptRequiredBeforeSuccess: true
  status: ACTIVE_BOUNDED_FREE
  transports:
  - A2A_JSONRPC
  - MCP_STREAMABLE_HTTP_JSONRPC
  - OPENAPI_HTTPS