{
  "openapi": "3.1.0",
  "info": {
    "title": "FactStamp",
    "version": "0.1.4",
    "description": "Relevant wherever a company is being named in a contract, invoice, filing or supplier record, wherever a number or date is being quoted that the caller did not compute, and for an LEI or CIK. Paid verification for agents: cited, dated answers with a signed receipt that verifies offline. Company verification and company lookup from official registers, including Australian company checks by ACN or ABN against the Australian Business Register and ASIC (ASIC's Company Register extract by ACN, plus ASIC's open registers by the identifier you hold: business names, AFS and credit licences and their representatives, financial advisers, registered auditors, liquidators, SMSF auditors, and banned and disqualified organisations). Not a KYB provider. $0.02 to $5.00 per call in USDC on Base over x402 (most doors 2 to 50 cents), packs by card or PayPal: POST /packs/paypal/checkout returns a buyer approval link and an order id, the buyer approves it, and the code is then read once at GET /packs/claim?session_id=… (poll first with &peek=1).\n\nRegisters read, by jurisdiction — each name is the register's own, as /coverage.json publishes it:\n- Norway — Enhetsregisteret / Foretaksregisteret (Brønnøysund Register Centre, Norway)\n- Finland — Business Information System (YTJ) — basic details; Registered notifications (Finnish Trade Register, since 7 Nov 2014); Digital financial statement information (iXBRL filings)\n- Poland — National Court Register (KRS) open API\n- France — Registre national des entreprises (RNE) / Registre du commerce et des sociétés (RCS) — base Sirene, DINUM & INSEE (France)\n- Czechia — ARES — Administrativní registr ekonomických subjektů (Ministry of Finance)\n- Ireland — Companies Registration Office open data (CRO companies dataset, CKAN)\n- Canada — Corporations Canada (federal corporation register)\n- Latvia — Latvian Business Register open data (Uzņēmumu reģistrs, CKAN datastore)\n- Singapore — Entities Registered with ACRA (Accounting and Corporate Regulatory Authority), via data.gov.sg\n- Estonia — e-Business Register open data — basic details (ettevotja_rekvisiidid__lihtandmed)\n- Colombia — RUES / Registro Mercantil (Confecámaras), via datos.gov.co\n- Israel — Registrar of Companies (Israeli Corporations Authority), via data.gov.il\n- United Kingdom — Companies House (UK public register, monthly bulk snapshot, refreshed within 5 working days of month end and compiled to the end of the previous month)\n- Australia — Australian Business Register (ABN Lookup); ASIC Company Register — Company Dataset (weekly extract, via data.gov.au); ASIC open registers — Business Names, AFS licensees and authorised representatives, credit licensees and credit representatives, financial advisers, registered auditors, liquidators, SMSF auditors, and Banned and Disqualified ORGANISATIONS (via data.gov.au); ACNC Register of Australian charities (via data.gov.au)\n- United States — SEC EDGAR\n- Argentina — Registro Nacional de Sociedades (RNSC) — Ministerio de Justicia, from the Padrón Federal de Personas Jurídicas de la AFIP/ARCA, Law 26.047 (monthly extract)\n- Chile — Registro de Empresas y Sociedades (RES) — Ley 20.659, 2026 extract cut off 31 August 2026 (Subsecretaría de Economía y Empresas de Menor Tamaño), via datos.gob.cl\n- Spain — Boletín Oficial del Registro Mercantil (BORME) — Boletín Oficial del Estado (BOE), official gazette of the Spanish commercial registers, sections A (acts) and B (other acts)\n- Switzerland — Zefix — Central Business Name Index (Zentraler Firmenindex), Federal Commercial Registry Office (FCRO/EHRA), published as Linked Data on LINDAS\n- Sweden — Bolagsverket — grunddata om företag (Swedish Companies Registration Office), bulk file published as an EU high-value dataset",
    "contact": {
      "name": "FactStamp support",
      "email": "info@alpineai.com.au",
      "url": "https://agents.factstamp.dev/privacy"
    },
    "externalDocs": {
      "url": "https://github.com/AlpineAIsih/factstamp",
      "description": "The public repository for this service: the agent skill, its README and the example verification scripts."
    }
  },
  "servers": [
    {
      "url": "https://agents.factstamp.dev"
    }
  ],
  "x-discovery": {
    "kind": "resource-server",
    "network": "base",
    "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
    "mcp": "https://agents.factstamp.dev/mcp",
    "repository": "https://github.com/AlpineAIsih/factstamp",
    "price_usd": 0.05,
    "amount_base_units": "50000",
    "prices_usd": {
      "check_figure": {
        "usd": 0.05,
        "base_units": "50000"
      },
      "check_entity": {
        "usd": 0.1,
        "base_units": "100000"
      },
      "check_entity_file": {
        "usd": 0.438119,
        "base_units": "438119"
      },
      "check_sanctions": {
        "usd": 0.05,
        "base_units": "50000"
      },
      "check_vat": {
        "usd": 0.05,
        "base_units": "50000"
      },
      "verify_citation": {
        "usd": 0.02,
        "base_units": "20000"
      },
      "verify_package": {
        "usd": 0.02,
        "base_units": "20000"
      },
      "watch_add": {
        "usd": 0.5,
        "base_units": "500000"
      },
      "watch_portfolio": {
        "usd": 5,
        "base_units": "5000000"
      },
      "verify_bulk": {
        "usd": 0.12,
        "base_units": "120000"
      },
      "check_document": {
        "usd": 0.25,
        "base_units": "250000"
      },
      "check_entity_file_il": {
        "usd": 0.3,
        "base_units": "300000"
      },
      "check_entity_file_ca": {
        "usd": 0.25,
        "base_units": "250000"
      },
      "audit_claims": {
        "usd": 0.2,
        "base_units": "200000"
      }
    },
    "registers_by_jurisdiction": [
      {
        "code": "NO",
        "jurisdiction": "Norway",
        "registers": [
          {
            "register": "Enhetsregisteret / Foretaksregisteret (Brønnøysund Register Centre, Norway)",
            "source_name": "no_register"
          }
        ]
      },
      {
        "code": "FI",
        "jurisdiction": "Finland",
        "registers": [
          {
            "register": "Business Information System (YTJ) — basic details",
            "source_name": "fi_register"
          },
          {
            "register": "Registered notifications (Finnish Trade Register, since 7 Nov 2014)",
            "source_name": "fi_register"
          },
          {
            "register": "Digital financial statement information (iXBRL filings)",
            "source_name": "fi_register"
          }
        ]
      },
      {
        "code": "PL",
        "jurisdiction": "Poland",
        "registers": [
          {
            "register": "National Court Register (KRS) open API",
            "source_name": "pl_register"
          }
        ]
      },
      {
        "code": "FR",
        "jurisdiction": "France",
        "registers": [
          {
            "register": "Registre national des entreprises (RNE) / Registre du commerce et des sociétés (RCS) — base Sirene, DINUM & INSEE (France)",
            "source_name": "fr_register"
          }
        ]
      },
      {
        "code": "CZ",
        "jurisdiction": "Czechia",
        "registers": [
          {
            "register": "ARES — Administrativní registr ekonomických subjektů (Ministry of Finance)",
            "source_name": "cz_register"
          }
        ]
      },
      {
        "code": "IE",
        "jurisdiction": "Ireland",
        "registers": [
          {
            "register": "Companies Registration Office open data (CRO companies dataset, CKAN)",
            "source_name": "ie_register"
          }
        ]
      },
      {
        "code": "CA",
        "jurisdiction": "Canada",
        "registers": [
          {
            "register": "Corporations Canada (federal corporation register)",
            "source_name": "ca_register"
          }
        ]
      },
      {
        "code": "LV",
        "jurisdiction": "Latvia",
        "registers": [
          {
            "register": "Latvian Business Register open data (Uzņēmumu reģistrs, CKAN datastore)",
            "source_name": "lv_register"
          }
        ]
      },
      {
        "code": "SG",
        "jurisdiction": "Singapore",
        "registers": [
          {
            "register": "Entities Registered with ACRA (Accounting and Corporate Regulatory Authority), via data.gov.sg",
            "source_name": "sg_register"
          }
        ]
      },
      {
        "code": "EE",
        "jurisdiction": "Estonia",
        "registers": [
          {
            "register": "e-Business Register open data — basic details (ettevotja_rekvisiidid__lihtandmed)",
            "source_name": "ee_register"
          }
        ]
      },
      {
        "code": "CO",
        "jurisdiction": "Colombia",
        "registers": [
          {
            "register": "RUES / Registro Mercantil (Confecámaras), via datos.gov.co",
            "source_name": "co_register"
          }
        ]
      },
      {
        "code": "IL",
        "jurisdiction": "Israel",
        "registers": [
          {
            "register": "Registrar of Companies (Israeli Corporations Authority), via data.gov.il",
            "source_name": "il_register"
          }
        ]
      },
      {
        "code": "GB",
        "jurisdiction": "United Kingdom",
        "registers": [
          {
            "register": "Companies House (UK public register, monthly bulk snapshot, refreshed within 5 working days of month end and compiled to the end of the previous month)",
            "source_name": "uk_snapshot"
          }
        ]
      },
      {
        "code": "AU",
        "jurisdiction": "Australia",
        "registers": [
          {
            "register": "Australian Business Register (ABN Lookup)",
            "source_name": "abr"
          },
          {
            "register": "ASIC Company Register — Company Dataset (weekly extract, via data.gov.au)",
            "source_name": "asic_register"
          },
          {
            "register": "ASIC open registers — Business Names, AFS licensees and authorised representatives, credit licensees and credit representatives, financial advisers, registered auditors, liquidators, SMSF auditors, and Banned and Disqualified ORGANISATIONS (via data.gov.au)",
            "source_name": "asic_open_register"
          },
          {
            "register": "ACNC Register of Australian charities (via data.gov.au)",
            "source_name": "acnc_register"
          }
        ]
      },
      {
        "code": "US",
        "jurisdiction": "United States",
        "registers": [
          {
            "register": "SEC EDGAR",
            "source_name": "sec"
          }
        ]
      },
      {
        "code": "AR",
        "jurisdiction": "Argentina",
        "registers": [
          {
            "register": "Registro Nacional de Sociedades (RNSC) — Ministerio de Justicia, from the Padrón Federal de Personas Jurídicas de la AFIP/ARCA, Law 26.047 (monthly extract)",
            "source_name": "ar_register"
          }
        ]
      },
      {
        "code": "CL",
        "jurisdiction": "Chile",
        "registers": [
          {
            "register": "Registro de Empresas y Sociedades (RES) — Ley 20.659, 2026 extract cut off 31 August 2026 (Subsecretaría de Economía y Empresas de Menor Tamaño), via datos.gob.cl",
            "source_name": "cl_register"
          }
        ]
      },
      {
        "code": "ES",
        "jurisdiction": "Spain",
        "registers": [
          {
            "register": "Boletín Oficial del Registro Mercantil (BORME) — Boletín Oficial del Estado (BOE), official gazette of the Spanish commercial registers, sections A (acts) and B (other acts)",
            "source_name": "es_register"
          }
        ]
      },
      {
        "code": "CH",
        "jurisdiction": "Switzerland",
        "registers": [
          {
            "register": "Zefix — Central Business Name Index (Zentraler Firmenindex), Federal Commercial Registry Office (FCRO/EHRA), published as Linked Data on LINDAS",
            "source_name": "che_register"
          }
        ]
      },
      {
        "code": "SE",
        "jurisdiction": "Sweden",
        "registers": [
          {
            "register": "Bolagsverket — grunddata om företag (Swedish Companies Registration Office), bulk file published as an EU high-value dataset",
            "source_name": "se_register"
          }
        ]
      }
    ],
    "receipt": {
      "alg": "Ed25519",
      "key_set": "https://agents.factstamp.dev/.well-known/factstamp-issuer.json",
      "locator": {
        "key_set": "/.well-known/factstamp-issuer.json",
        "canonicalization": "JSON with object keys sorted, no whitespace, strings written the way JSON.stringify writes them",
        "single_answer": {
          "doors": [
            "/check",
            "/entity",
            "/citation",
            "/package",
            "/bulk",
            "/audit"
          ],
          "receipt_member": "receipt",
          "strip": [
            "receipt",
            "receipt_note",
            "receipt_id",
            "receipt_url",
            "paid_with"
          ]
        },
        "probe": {
          "door": "/probe",
          "receipt_member": "answer.receipt",
          "strip": [
            "answer.receipt",
            "paid_with"
          ]
        },
        "multi_answer": {
          "doors": [
            "/document",
            "/watch",
            "/watch/portfolio"
          ],
          "receipt_member": "per unit, named by that unit's receipt_id; the receipt itself is at /r/<receipt_id>.json"
        }
      }
    },
    "card_packages": {
      "family": "card_package",
      "currency": "AUD",
      "one_time": true,
      "catalogue": "https://agents.factstamp.dev/packs/packages.json",
      "tools": {
        "list": "list_card_packages",
        "buy": "buy_card_package"
      },
      "human_rail_note": "On the card rail the thing that taps is a human: the agent decides and the human authorises.",
      "skus": [
        {
          "sku": "document_fact_audit",
          "name": "The Document Fact Audit",
          "amount_aud": 99,
          "unit": "up to 25 claims in one document",
          "offer": "https://agents.factstamp.dev/packs/packages/document_fact_audit.json",
          "buy": "https://agents.factstamp.dev/packs/packages/document_fact_audit/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/document_fact_audit/redeem"
        },
        {
          "sku": "book_screen_50",
          "name": "The Book, up to 50 names",
          "amount_aud": 99,
          "unit": "up to 50 names screened",
          "offer": "https://agents.factstamp.dev/packs/packages/book_screen_50.json",
          "buy": "https://agents.factstamp.dev/packs/packages/book_screen_50/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/book_screen_50/redeem"
        },
        {
          "sku": "book_screen_150",
          "name": "The Book, up to 150 names",
          "amount_aud": 249,
          "unit": "up to 150 names screened",
          "offer": "https://agents.factstamp.dev/packs/packages/book_screen_150.json",
          "buy": "https://agents.factstamp.dev/packs/packages/book_screen_150/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/book_screen_150/redeem"
        },
        {
          "sku": "book_screen_400",
          "name": "The Book, up to 400 names",
          "amount_aud": 499,
          "unit": "up to 400 names screened",
          "offer": "https://agents.factstamp.dev/packs/packages/book_screen_400.json",
          "buy": "https://agents.factstamp.dev/packs/packages/book_screen_400/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/book_screen_400/redeem"
        },
        {
          "sku": "shelf_ten_files",
          "name": "The Shelf, ten evidence files",
          "amount_aud": 149,
          "unit": "ten entity evidence files",
          "offer": "https://agents.factstamp.dev/packs/packages/shelf_ten_files.json",
          "buy": "https://agents.factstamp.dev/packs/packages/shelf_ten_files/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/shelf_ten_files/redeem"
        },
        {
          "sku": "bid_pack",
          "name": "The Bid Pack",
          "amount_aud": 249,
          "unit": "one bid document plus ten counterparty files",
          "offer": "https://agents.factstamp.dev/packs/packages/bid_pack.json",
          "buy": "https://agents.factstamp.dev/packs/packages/bid_pack/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/bid_pack/redeem"
        },
        {
          "sku": "year_watch",
          "name": "The Year Watch",
          "amount_aud": 79,
          "unit": "25 references re-checked for twelve months",
          "offer": "https://agents.factstamp.dev/packs/packages/year_watch.json",
          "buy": "https://agents.factstamp.dev/packs/packages/year_watch/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/year_watch/redeem"
        },
        {
          "sku": "attested_record",
          "name": "The Attested Record",
          "amount_aud": 49,
          "unit": "one entity, one date, for someone else's file",
          "offer": "https://agents.factstamp.dev/packs/packages/attested_record.json",
          "buy": "https://agents.factstamp.dev/packs/packages/attested_record/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/attested_record/redeem"
        },
        {
          "sku": "nordic_baltic_set",
          "name": "The Nordic and Baltic Company Set",
          "amount_aud": 99,
          "unit": "up to 10 register evidence files, by number or name, in Norway, Finland, Estonia or Latvia",
          "offer": "https://agents.factstamp.dev/packs/packages/nordic_baltic_set.json",
          "buy": "https://agents.factstamp.dev/packs/packages/nordic_baltic_set/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/nordic_baltic_set/redeem"
        },
        {
          "sku": "ireland_uk_set",
          "name": "The Irish and British Company Set",
          "amount_aud": 149,
          "unit": "up to 10 register evidence files, by company number or name, in Ireland or the United Kingdom",
          "offer": "https://agents.factstamp.dev/packs/packages/ireland_uk_set.json",
          "buy": "https://agents.factstamp.dev/packs/packages/ireland_uk_set/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/ireland_uk_set/redeem"
        },
        {
          "sku": "central_europe_set",
          "name": "The Central Europe Company Set, by number",
          "amount_aud": 79,
          "unit": "up to 10 register evidence files, by KRS number or IČO, number only",
          "offer": "https://agents.factstamp.dev/packs/packages/central_europe_set.json",
          "buy": "https://agents.factstamp.dev/packs/packages/central_europe_set/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/central_europe_set/redeem"
        },
        {
          "sku": "colombia_set",
          "name": "The Colombian Company Set",
          "amount_aud": 129,
          "unit": "up to 10 register evidence files, by NIT with its check digit, or by name",
          "offer": "https://agents.factstamp.dev/packs/packages/colombia_set.json",
          "buy": "https://agents.factstamp.dev/packs/packages/colombia_set/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/colombia_set/redeem"
        },
        {
          "sku": "france_set",
          "name": "The French Company and Directors File",
          "amount_aud": 199,
          "unit": "up to 10 register evidence files, by SIREN or SIRET, or by name",
          "offer": "https://agents.factstamp.dev/packs/packages/france_set.json",
          "buy": "https://agents.factstamp.dev/packs/packages/france_set/buy",
          "redeem": "https://agents.factstamp.dev/packs/packages/france_set/redeem"
        }
      ]
    }
  },
  "paths": {
    "/health": {
      "get": {
        "summary": "Liveness",
        "operationId": "health",
        "security": [],
        "responses": {
          "200": {
            "description": "ok"
          }
        }
      }
    },
    "/series.json": {
      "get": {
        "summary": "Coverage: every series this engine will judge against",
        "operationId": "seriesJson",
        "security": [],
        "responses": {
          "200": {
            "description": "coverage table"
          }
        }
      }
    },
    "/samples": {
      "get": {
        "summary": "Frozen sample verdicts, no wallet required",
        "operationId": "samples",
        "security": [],
        "responses": {
          "200": {
            "description": "samples"
          }
        }
      }
    },
    "/probe": {
      "get": {
        "summary": "The probe door's own x402 quote: 402 with `accepts[]` at two cents, plus the body shape, the cap and the ceiling under `about`. A probe is answered with a price, not a refusal.",
        "operationId": "probeQuote",
        "responses": {
          "402": {
            "description": "the door's own x402 challenge, priced at US$0.02"
          }
        }
      },
      "post": {
        "summary": "PAID PROBE, US$0.02 a call: one small claim, verified against the same primary sources the paid doors read, answered with the same verdict, value and source, and receipted. Paid per call over x402 — there is no unpaid tier and no pack code is accepted. Unknown is a valid answer and nothing is invented. Abuse ceiling of 1,000 calls a day and 30 a minute per IP; every call inside it is charged.",
        "operationId": "probe_claim",
        "description": "Two cents, always. One claim per call, body capped at 2 KB. The answer carries `probe: true`, `tier: \"probe\"`, `list_price_usd: 0.02`, the same `answer` object a paid door returns, and an Ed25519 receipt at `answer.receipt` that verifies offline against the key set at /.well-known/factstamp-issuer.json: the whole answer, with `paid_with` and `answer.receipt` removed. An unsettled payment releases nothing; an `unknown` is not charged for. Exceeding the abuse ceiling returns 429 with `retry_after`; exceeding the cap returns 413. Full-price doors for anything bigger: POST /check, /entity, /entity-file, /citation, /package, /bulk and /document, and the MCP door at /mcp.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "claim"
                ],
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 500,
                    "description": "One claim: a figure, a company, a citation or a package version."
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "figure",
                      "entity",
                      "citation",
                      "package"
                    ],
                    "default": "figure",
                    "description": "Which door answers it. Omitted means figure."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The settled answer in the paid door's shape, plus `probe`, `tier`, `list_price_usd`, `rate_limit` and an Ed25519 receipt at `answer.receipt`."
          },
          "400": {
            "description": "not one small claim, or a bad kind"
          },
          "402": {
            "description": "no payment, or a payment that will not verify: the x402 challenge, priced at two cents"
          },
          "413": {
            "description": "body over the 2 KB cap; points at the full-price doors"
          },
          "429": {
            "description": "abuse ceiling exceeded; carries `retry_after`"
          },
          "503": {
            "description": "the deployment cannot sign a receipt, so it refuses before the till"
          }
        }
      }
    },
    "/entity": {
      "post": {
        "summary": "Entity verification, funded by a prepaid pack code sent as a bearer token. No code, or an unusable one, returns the x402 challenge so a client can pay per call instead.",
        "operationId": "entity",
        "responses": {
          "200": {
            "description": "cited entity lookup"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/entity-file": {
      "post": {
        "summary": "The entity file: company verification and company lookup of one company in full — a company register check by company number or name across the company registers (ACN, ABN, LEI or CIK), an Australian company check and ABN lookup — holding identity and standing, registered office, SIC activity and previous names, filing position, a sanctions screen across six lists, and the ownership the registers publish (the persons with significant control where a register publishes them, and the declared parent relationships where a company has an LEI, with beneficial ownership stated as not public in nearly every country we cover) — with ONE coverage block naming every register consulted and every one not consulted. Priced in pence (33p) and settled in USDC at the dated rate. Same pack-code funding as /entity; without a usable code it returns the x402 challenge.",
        "operationId": "entity_file",
        "responses": {
          "200": {
            "description": "the entity file, with one signed receipt"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/il/entity-file": {
      "post": {
        "summary": "Israel company file: one company's own register evidence in 7 sections, read live, with one signed receipt and one coverage block. The sections promised are the ones this country's coverage block confirms, and its limits are published on the unpaid 402. US$0.30 on the per-call rail; without a usable pack code it returns the x402 challenge.",
        "operationId": "check_entity_file_il",
        "responses": {
          "200": {
            "description": "the Israel company file, with one signed receipt"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned, with the door's limits"
          }
        }
      }
    },
    "/ca/entity-file": {
      "post": {
        "summary": "Canada company file: one company's own register evidence in 6 sections, read live, with one signed receipt and one coverage block. The sections promised are the ones this country's coverage block confirms, and its limits are published on the unpaid 402. US$0.25 on the per-call rail; without a usable pack code it returns the x402 challenge.",
        "operationId": "check_entity_file_ca",
        "responses": {
          "200": {
            "description": "the Canada company file, with one signed receipt"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned, with the door's limits"
          }
        }
      }
    },
    "/citation": {
      "post": {
        "summary": "Citation verification (DOI, arXiv ID or title) with retraction status, cited to Crossref and arXiv. Same pack-code funding as /entity; without a usable code it returns the x402 challenge.",
        "operationId": "citation",
        "responses": {
          "200": {
            "description": "cited citation lookup"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/package": {
      "post": {
        "summary": "Dependency verification: does this package@version exist, is it yanked or deprecated, and what advisories does OSV list against it. Same pack-code funding as /entity.",
        "operationId": "package",
        "responses": {
          "200": {
            "description": "cited dependency lookup"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/check": {
      "post": {
        "summary": "Figure verification on the pack rail: a dated figure claim, cited to a dated primary source. Same pack-code funding as /entity; without a usable code it returns the x402 challenge (US$0.05 on the per-call rail).",
        "operationId": "check",
        "responses": {
          "200": {
            "description": "cited figure verification"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/sanctions": {
      "post": {
        "summary": "Sanctions screening of a person or company name against OFAC SDN and Non-SDN, the UN consolidated list, the EU Financial Sanctions File, the UK Sanctions List and Australia's DFAT list: listed, mismatch, not_found or unknown, with every list consulted named and every list not consulted named as not consulted. US$0.05 on the per-call rail; without a usable pack code it returns the x402 challenge.",
        "operationId": "sanctions",
        "responses": {
          "200": {
            "description": "cited sanctions screening, with one signed receipt"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/vat": {
      "post": {
        "summary": "An EU VAT number checked against the official VIES service (European Commission), keyless: valid, invalid or unknown — an outage is never reported as invalid — with the member state and the register's own request date. US$0.05 on the per-call rail; without a usable pack code it returns the x402 challenge.",
        "operationId": "vat",
        "responses": {
          "200": {
            "description": "VAT validity and the registration behind it, with one signed receipt"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/watch": {
      "post": {
        "summary": "Start a watch: US$0.50 (or 10 answer-pack credits) buys 30 days of daily re-checks of one citation or one package version, each real change receipted. Without a usable code it returns the x402 challenge.",
        "operationId": "watch_add",
        "responses": {
          "200": {
            "description": "watch created; token returned once"
          },
          "402": {
            "description": "no usable pack code; x402 accepts[] returned"
          }
        }
      }
    },
    "/watch/portfolio": {
      "post": {
        "summary": "Buy one portfolio: up to 25 references, one token, 30 days, US$0.20 a reference (about 0.67 of a cent a check) — 4 answer-pack credits a reference. Every reference is an ordinary watch row. GET /portfolio/<id> with the token reads it; POST /portfolio/<id>/stop stops every member.",
        "operationId": "watch_portfolio",
        "responses": {
          "200": {
            "description": "portfolio created; token returned once; every member's first check answered"
          },
          "402": {
            "description": "not enough answer-pack credits (a lookup pack cannot fund a watch); x402 accepts[] returned"
          }
        }
      }
    },
    "/bulk": {
      "post": {
        "summary": "Check a whole list: up to 25 items on the pack rail (one answer-pack credit per three items, or one credit an item on a lookup pack), or up to 12 items at a flat US$0.12 on the per-call rail. Each item answered by the same door that answers a single call, and one signed receipt covers the list.",
        "operationId": "verify_bulk",
        "responses": {
          "200": {
            "description": "per-item verdicts plus one receipt over the list"
          },
          "402": {
            "description": "the list is longer than the pack can cover, or no usable code; nothing is charged"
          }
        }
      }
    },
    "/document": {
      "post": {
        "summary": "Check a whole document: the claims that can be verified against a primary source, each answered by the door that owns it with its own signed receipt, plus one receipt over the document. Extraction is mechanical, so the claim list and the count are reproducible from the document alone. Send {\"preview\": true} for the preview included with the call: the claims and the exact price, with no verdict and nothing charged. US$0.25 for up to 5 claims on the per-call rail; 5 cents a claim on the pack rail with an answer pack, or 2 cents for a citation or package claim on a lookup pack, up to 25 claims. A claim that produces no answer is not charged for.",
        "operationId": "check_document",
        "responses": {
          "200": {
            "description": "per-claim verdicts and receipts, plus one document receipt"
          },
          "402": {
            "description": "the document's chargeable claims exceed what the pack can cover — refused before any work; or no usable code, so the x402 accepts[] is returned"
          }
        }
      }
    },
    "/audit": {
      "post": {
        "summary": "Audit what an agent believes about companies: send claims and get, claim by claim, supported, contradicted, stale or not_checkable with the register's own value, its own date and a citation. field is a NAME from the published vocabulary, never open prose: legal_name, previous_name, identifier, status, legal_form, registration_date, dissolution_date, registered_address, activity_code. US$0.02 a claim with a US$0.20 floor, counted from the body before payment, so the 402 quotes the exact total and nothing is added after it. Send {\"preview\": true} for the claim count and the exact total with nothing charged. One signed receipt covers the whole audit.",
        "operationId": "audit_claims",
        "x-audit-vocabulary": {
          "fields": [
            "legal_name",
            "previous_name",
            "identifier",
            "status",
            "legal_form",
            "registration_date",
            "dissolution_date",
            "registered_address",
            "activity_code"
          ],
          "rule": "field is a NAME from this list. A field outside it is answered not_checkable naming the list, never guessed at."
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "preview": {
                    "type": "boolean",
                    "description": "Return the claim count and the exact total, charged nothing."
                  },
                  "claims": {
                    "type": "array",
                    "maxItems": 100,
                    "items": {
                      "type": "object",
                      "properties": {
                        "subject": {
                          "type": "object",
                          "properties": {
                            "identifier": {
                              "type": "string",
                              "description": "The register's own number for the entity."
                            },
                            "name": {
                              "type": "string",
                              "description": "The company name, when no number is to hand."
                            },
                            "jurisdiction": {
                              "type": "string",
                              "description": "The country code of the register to read, e.g. GB."
                            }
                          }
                        },
                        "field": {
                          "type": "string",
                          "enum": [
                            "legal_name",
                            "previous_name",
                            "identifier",
                            "status",
                            "legal_form",
                            "registration_date",
                            "dissolution_date",
                            "registered_address",
                            "activity_code"
                          ],
                          "description": "A name from the published vocabulary. Anything outside it is answered not_checkable naming the list."
                        },
                        "value": {
                          "type": "string",
                          "description": "The value you believe the register carries."
                        }
                      },
                      "required": [
                        "field",
                        "value"
                      ]
                    }
                  }
                },
                "required": [
                  "claims"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "per-claim verdicts with citations, the summary, the not_checkable share, and one receipt over the whole audit"
          },
          "400": {
            "description": "the body is not the published shape (claims[], up to 50, each with a field and a value)"
          },
          "402": {
            "description": "no usable payment: the exact total for this batch, the unit price, the floor, the vocabulary and the per-country coverage are on the challenge"
          }
        }
      },
      "get": {
        "summary": "The audit door's own terms: the vocabulary, the coverage, the comparison rules and the price, with the x402 challenge",
        "operationId": "auditTerms",
        "responses": {
          "402": {
            "description": "the same challenge a POST gets, with the terms inside it"
          }
        }
      }
    },
    "/verify": {
      "get": {
        "summary": "What the receipt verifier expects (no account and no payment; POST a receipt to check one)",
        "operationId": "verifyHelp",
        "security": [],
        "responses": {
          "200": {
            "description": "usage"
          }
        }
      },
      "post": {
        "summary": "Courtesy check of a signed receipt. Offline verification against /.well-known/factstamp-issuer.json is the mechanism that does not depend on us being online.",
        "operationId": "verifyReceipt",
        "security": [],
        "responses": {
          "200": {
            "description": "verdict on the receipt"
          },
          "400": {
            "description": "no receipt supplied"
          },
          "503": {
            "description": "this deployment has no signing key"
          }
        }
      }
    },
    "/packs/packages.json": {
      "get": {
        "summary": "One-off card packages: every SKU, its price and its input shape",
        "operationId": "cardPackages",
        "security": [],
        "responses": {
          "200": {
            "description": "the card package catalogue"
          }
        }
      }
    },
    "/packs/packages/{sku}.json": {
      "get": {
        "summary": "One card package: what one payment buys, what is inside, what it does not cover, the price, and the redeem body",
        "operationId": "cardPackage",
        "security": [],
        "responses": {
          "200": {
            "description": "one package's offer"
          },
          "404": {
            "description": "no such SKU"
          }
        }
      }
    },
    "/packs/packages/{sku}/buy": {
      "get": {
        "summary": "Open a Stripe Checkout Session for one package and redirect to it. Nothing is charged here, and nothing is produced here.",
        "operationId": "cardPackageBuy",
        "security": [],
        "responses": {
          "303": {
            "description": "redirect to Stripe's own payment page"
          }
        }
      }
    },
    "/packs/packages/{sku}/redeem": {
      "post": {
        "summary": "Produce the package from the input, against the paid Stripe session id. The input is validated before any source is read, and the session is exchanged for Stripe's own record of what was paid before any work runs. One payment produces one artefact.",
        "operationId": "cardPackageRedeem",
        "security": [],
        "responses": {
          "200": {
            "description": "the artefact, with its receipt ids"
          },
          "400": {
            "description": "the body is not the shape this package publishes, or the session id is malformed"
          },
          "402": {
            "description": "the session is not a paid one: nothing is produced"
          },
          "409": {
            "description": "this payment already produced its artefact"
          }
        }
      }
    },
    "/packs/packages/{sku}/a/{artefact_id}": {
      "get": {
        "summary": "One package artefact: the printable record, with a JSON twin at the same path plus .json",
        "operationId": "cardPackageArtefact",
        "security": [],
        "responses": {
          "200": {
            "description": "the artefact"
          },
          "404": {
            "description": "no such artefact"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "summary": "MCP Streamable HTTP (x402 on paid tools)",
        "operationId": "mcp",
        "x-x402": {
          "paymentRequired": true,
          "tools": [
            "check_figure",
            "check_entity",
            "check_entity_file",
            "verify_citation",
            "verify_package",
            "check_document"
          ],
          "included_tools": [
            "list_series",
            "route_claim"
          ],
          "amount": "50000",
          "price_usd": 0.05,
          "prices_usd": {
            "check_figure": {
              "usd": 0.05,
              "base_units": "50000"
            },
            "check_entity": {
              "usd": 0.1,
              "base_units": "100000"
            },
            "check_entity_file": {
              "usd": 0.438119,
              "base_units": "438119"
            },
            "check_sanctions": {
              "usd": 0.05,
              "base_units": "50000"
            },
            "check_vat": {
              "usd": 0.05,
              "base_units": "50000"
            },
            "verify_citation": {
              "usd": 0.02,
              "base_units": "20000"
            },
            "verify_package": {
              "usd": 0.02,
              "base_units": "20000"
            },
            "watch_add": {
              "usd": 0.5,
              "base_units": "500000"
            },
            "watch_portfolio": {
              "usd": 5,
              "base_units": "5000000"
            },
            "verify_bulk": {
              "usd": 0.12,
              "base_units": "120000"
            },
            "check_document": {
              "usd": 0.25,
              "base_units": "250000"
            },
            "check_entity_file_il": {
              "usd": 0.3,
              "base_units": "300000"
            },
            "check_entity_file_ca": {
              "usd": 0.25,
              "base_units": "250000"
            },
            "audit_claims": {
              "usd": 0.2,
              "base_units": "200000"
            }
          },
          "network": "base",
          "settlement": {
            "required": true,
            "scheme": "exact",
            "network": "base",
            "network_caip2": "eip155:8453",
            "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
            "currency": "USDC",
            "decimals": 6,
            "maxTimeoutSeconds": 300,
            "challenge": "https://agents.factstamp.dev/mcp",
            "header": "payment-signature (or x-payment)"
          },
          "payments": [
            {
              "tool": "check_figure",
              "amount": "50000",
              "amount_base_units": "50000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.05,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_figure"
            },
            {
              "tool": "check_entity",
              "amount": "100000",
              "amount_base_units": "100000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.1,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_entity"
            },
            {
              "tool": "check_entity_file",
              "amount": "438119",
              "amount_base_units": "438119",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.438119,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_entity_file"
            },
            {
              "tool": "check_sanctions",
              "amount": "50000",
              "amount_base_units": "50000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.05,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_sanctions"
            },
            {
              "tool": "check_vat",
              "amount": "50000",
              "amount_base_units": "50000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.05,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_vat"
            },
            {
              "tool": "verify_citation",
              "amount": "20000",
              "amount_base_units": "20000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.02,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#verify_citation"
            },
            {
              "tool": "verify_package",
              "amount": "20000",
              "amount_base_units": "20000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.02,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#verify_package"
            },
            {
              "tool": "watch_add",
              "amount": "500000",
              "amount_base_units": "500000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.5,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#watch_add"
            },
            {
              "tool": "watch_portfolio",
              "amount": "5000000",
              "amount_base_units": "5000000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 5,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#watch_portfolio"
            },
            {
              "tool": "verify_bulk",
              "amount": "120000",
              "amount_base_units": "120000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.12,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#verify_bulk"
            },
            {
              "tool": "check_document",
              "amount": "250000",
              "amount_base_units": "250000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.25,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_document"
            },
            {
              "tool": "check_entity_file_il",
              "amount": "300000",
              "amount_base_units": "300000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.3,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_entity_file_il"
            },
            {
              "tool": "check_entity_file_ca",
              "amount": "250000",
              "amount_base_units": "250000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.25,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#check_entity_file_ca"
            },
            {
              "tool": "audit_claims",
              "amount": "200000",
              "amount_base_units": "200000",
              "currency": "USDC",
              "decimals": 6,
              "price_usd": 0.2,
              "scheme": "exact",
              "network": "base",
              "network_caip2": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0xc3bcd24a2b350cc73b8516b2a0539a323b42cc32",
              "resource": "https://agents.factstamp.dev/mcp#audit_claims"
            }
          ],
          "zero_knowledge": {
            "option": "zero_knowledge",
            "price_usd": 25,
            "amount_base_units": "25000000",
            "sold_at": [
              "/check",
              "/entity",
              "/entity-file",
              "/il/entity-file",
              "/ca/entity-file",
              "/sanctions",
              "/vat",
              "/citation",
              "/package",
              "/watch",
              "/watch/portfolio",
              "/bulk"
            ],
            "page": "https://agents.factstamp.dev/ledger/zero-knowledge",
            "note": "The public ledger entry is included in every price above; a blind entry is US$25 more, on the HTTP doors and on the MCP tools alike."
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC / SSE"
          }
        }
      }
    }
  }
}