Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
contact:
email: nicholas@csoai.org
name: CSOAI Ltd
url: https://councilof.ai/
description: 'Verification is free forever. Agents pay per artefact: issuance, assembly, cadence — never a grade. 23 axes measured · 14 model fleets · 0 separated leaders · 9 public leader scores · 9 fact runs · TIE is TIE · not a certificate. Operations with security [] are free and unauthenticated. Operations with x-payment-info are x402 doors; an amount appears only inside a door''s 402 challenge (documented as each door''s 402 example). Python''s default urllib User-Agent (Python-urllib/x.y) is refused at our CDN with 403 ''error code: 1010''. Send any User-Agent, e.g. urllib.request.Request(url, headers={''User-Agent'': ''my-check/1''}).'
license:
name: CC-BY-4.0
url: https://creativecommons.org/licenses/by/4.0/
title: Council of AI — Public Free API
version: 0.3+4a141228c8ec
x-guidance: 'Free board: GET /api/gspc — quote totals.lid verbatim, never compose a count. Paid doors are the operations carrying x-payment-info: GET without payment answers HTTP 402 with the x402 v2 challenge (accepts[0]: scheme exact, network eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31); pay it and retry with the X-PAYMENT header. Required query parameters carry an example that reaches the 402. Free previews are named per door under x-csoai.free_preview. Catalog: https://councilof.ai/.well-known/x402.json and https://councilof.ai/api/x402. Verify is free: https://councilof.ai/gspc-verify. Offer & Receipt emission is conditional: a 402 carries server-signed offers only when the Pages signing key is available; a settled 200 carries a signed receipt only when settlement exposes the required payer and transaction evidence and that key is available. The extension uses JWS/EdDSA, kid did:web:csoai.org#board-attestation-1, published at https://csoai.org/.well-known/did.json. Check either without trusting this document: POST it to /api/receipts/verify, or download https://councilof.ai/verifier/verify_receipt.py; default mode reads the public DID document, and a retained key document allows offline replay. 23 axes measured · 14 model fleets · 0 separated leaders · 9 public leader scores · 9 fact runs · TIE is TIE · not a certificate.'
servers:
- url: https://councilof.ai
tags:
- description: a 402 route priced at zero
name: free
paths:
/api/discover/chainlink:
get:
description: 'Subject discovery links for Chainlink / LINK: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
operationId: x402_discover_chainlink
parameters: []
responses:
'200':
content:
application/json:
schema:
description: 'Subject discovery links for Chainlink / LINK: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
type: object
description: 'Subject discovery links for Chainlink / LINK: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
'402':
content:
application/json:
example:
accepts:
- amount: '0'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
extra:
decimals: 6
name: USD Coin
symbol: USDC
version: '2'
maxAmountRequired: '0'
maxTimeoutSeconds: 300
network: eip155:8453
payTo: '0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31'
scheme: exact
error: Payment required
extensions:
bazaar:
info:
input:
method: GET
type: http
resource:
description: 'Subject discovery links for Chainlink / LINK: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
mimeType: application/json
url: https://councilof.ai/api/discover/chainlink
x402Version: 2
schema:
$ref: '#/components/schemas/X402PaymentRequired'
description: 'Payment required — the x402 v2 challenge. The PAYMENT-REQUIRED response header carries its minimal v2 subset (x402Version, error, resource, accepts[] payment fields); extensions and the csoai sidecar are in this body only. Pay accepts[0] (scheme exact, network eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31; amount in atomic units) and retry the same request with the X-PAYMENT header. Verification of the artefact stays free. The example is a captured challenge: its amount and any csoai_pricing dates are as captured, not a standing price. Amounts are set per request in the challenge and can change, so read accepts[] from a live 402 on every call.'
headers:
PAYMENT-REQUIRED:
description: 'base64(JSON) of the minimal v2 PaymentRequired: x402Version, error, resource, accepts[] (scheme, network, amount, asset, payTo, maxTimeoutSeconds, extra) — under 4 KiB'
schema:
type: string
summary: free door — /api/discover/chainlink
tags:
- free
x-csoai:
challenge:
amount_source: the door pins X402_AMOUNT to 0 and /.well-known/x402.json advertises amount 0
captured: false
door: https://councilof.ai/api/discover/chainlink
paid_for: null
x-payment-info:
protocols:
- x402
/api/discover/ondo:
get:
description: 'Subject discovery links for Ondo Finance / ONDO: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
operationId: x402_discover_ondo
parameters: []
responses:
'200':
content:
application/json:
schema:
description: 'Subject discovery links for Ondo Finance / ONDO: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
type: object
description: 'Subject discovery links for Ondo Finance / ONDO: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
'402':
content:
application/json:
example:
accepts:
- amount: '0'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
extra:
decimals: 6
name: USD Coin
symbol: USDC
version: '2'
maxAmountRequired: '0'
maxTimeoutSeconds: 300
network: eip155:8453
payTo: '0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31'
scheme: exact
error: Payment required
extensions:
bazaar:
info:
input:
method: GET
type: http
resource:
description: 'Subject discovery links for Ondo Finance / ONDO: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
mimeType: application/json
url: https://councilof.ai/api/discover/ondo
x402Version: 2
schema:
$ref: '#/components/schemas/X402PaymentRequired'
description: 'Payment required — the x402 v2 challenge. The PAYMENT-REQUIRED response header carries its minimal v2 subset (x402Version, error, resource, accepts[] payment fields); extensions and the csoai sidecar are in this body only. Pay accepts[0] (scheme exact, network eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31; amount in atomic units) and retry the same request with the X-PAYMENT header. Verification of the artefact stays free. The example is a captured challenge: its amount and any csoai_pricing dates are as captured, not a standing price. Amounts are set per request in the challenge and can change, so read accepts[] from a live 402 on every call.'
headers:
PAYMENT-REQUIRED:
description: 'base64(JSON) of the minimal v2 PaymentRequired: x402Version, error, resource, accepts[] (scheme, network, amount, asset, payTo, maxTimeoutSeconds, extra) — under 4 KiB'
schema:
type: string
summary: free door — /api/discover/ondo
tags:
- free
x-csoai:
challenge:
amount_source: the door pins X402_AMOUNT to 0 and /.well-known/x402.json advertises amount 0
captured: false
door: https://councilof.ai/api/discover/ondo
paid_for: null
x-payment-info:
protocols:
- x402
/api/discover/ondo-ousg:
get:
description: 'Subject discovery links for Ondo Finance OUSG on XRPL: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
operationId: x402_discover_ondo_ousg
parameters: []
responses:
'200':
content:
application/json:
schema:
description: 'Subject discovery links for Ondo Finance OUSG on XRPL: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
type: object
description: 'Subject discovery links for Ondo Finance OUSG on XRPL: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
'402':
content:
application/json:
example:
accepts:
- amount: '0'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
extra:
decimals: 6
name: USD Coin
symbol: USDC
version: '2'
maxAmountRequired: '0'
maxTimeoutSeconds: 300
network: eip155:8453
payTo: '0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31'
scheme: exact
error: Payment required
extensions:
bazaar:
info:
input:
method: GET
type: http
resource:
description: 'Subject discovery links for Ondo Finance OUSG on XRPL: identity, evidence routes, board and verify links. States: DISCOVERY_ONLY; the door reads nothing new and mints no measurement, and settling its zero-amount challenge charges nothing. Verification is free at /gspc-verify.'
mimeType: application/json
url: https://councilof.ai/api/discover/ondo-ousg
x402Version: 2
schema:
$ref: '#/components/schemas/X402PaymentRequired'
description: 'Payment required — the x402 v2 challenge. The PAYMENT-REQUIRED response header carries its minimal v2 subset (x402Version, error, resource, accepts[] payment fields); extensions and the csoai sidecar are in this body only. Pay accepts[0] (scheme exact, network eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31; amount in atomic units) and retry the same request with the X-PAYMENT header. Verification of the artefact stays free. The example is a captured challenge: its amount and any csoai_pricing dates are as captured, not a standing price. Amounts are set per request in the challenge and can change, so read accepts[] from a live 402 on every call.'
headers:
PAYMENT-REQUIRED:
description: 'base64(JSON) of the minimal v2 PaymentRequired: x402Version, error, resource, accepts[] (scheme, network, amount, asset, payTo, maxTimeoutSeconds, extra) — under 4 KiB'
schema:
type: string
summary: free door — /api/discover/ondo-ousg
tags:
- free
x-csoai:
challenge:
amount_source: the door pins X402_AMOUNT to 0 and /.well-known/x402.json advertises amount 0
captured: false
door: https://councilof.ai/api/discover/ondo-ousg
paid_for: null
x-payment-info:
protocols:
- x402
/api/free-door:
get:
description: 'Live board totals and the signed public root, free: the axis totals and Merkle root, served through a real x402 settle. It reads nothing new: the totals are the board''s own and the root is the published one. States: each axis MEASURED or UNMEASURED exactly as the board states it. Verification is free forever; the same bytes answer 200 at /api/gspc and /root.json.'
operationId: x402_free_door
parameters:
- description: x402 payment payload (base64 JSON) settling the zero-amount challenge. Omit it to read the 402; nothing is charged either way.
in: header
name: X-PAYMENT
required: false
schema:
type: string
- description: x402 v2 payment payload header, accepted in place of X-PAYMENT. Omit it to read the 402.
in: header
name: PAYMENT-SIGNATURE
required: false
schema:
type: string
responses:
'200':
content:
application/json:
schema:
description: 'Live board totals and the signed public root, free: the axis totals and Merkle root, served through a real x402 settle. It reads nothing new: the totals are the board''s own and the root is the published one. States: each axis MEASURED or UNMEASURED exactly as the board states it. Verification is free forever; the same bytes answer 200 at /api/gspc and /root.json.'
type: object
description: 'Live board totals and the signed public root, free: the axis totals and Merkle root, served through a real x402 settle. It reads nothing new: the totals are the board''s own and the root is the published one. States: each axis MEASURED or UNMEASURED exactly as the board states it. Verification is free forever; the same bytes answer 200 at /api/gspc and /root.json.'
'402':
content:
application/json:
example:
accepts:
- amount: '0'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
csoai_pricing:
campaign_id: null
fresh_compute_excluded: true
normal_amount_atomic: '0'
offered_amount_atomic: '0'
pricing_basis: STANDARD
product_id: csoai.product.request_attestation
sku_id: request_attestation
description: 'CSOAI free door: the live GSPC board totals and the public signed root, at a price of zero because it is free forever. That is the real price, not a promotion — a grade is never sold. Paid artefacts are catalogued at https://councilof.ai/api/x402. Measurement, not certification.'
extra:
decimals: 6
name: USD Coin
symbol: USDC
version: '2'
maxAmountRequired: '0'
maxTimeoutSeconds: 300
mimeType: application/json
network: eip155:8453
payTo: '0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31'
resource: https://councilof.ai/api/free-door
scheme: exact
error: Payment required
extensions:
bazaar:
info:
input:
method: GET
type: http
output:
example:
board: https://councilof.ai/api/gspc
price_usdc: 0
root: https://councilof.ai/root.json
schema: csoai.free-door/0.1
verify: https://councilof.ai/gspc-verify
type: json
schema:
$schema: https://json-schema.org/draft/2020-12/schema
properties:
input:
additionalProperties: false
properties:
method:
enum:
- GET
type: string
type:
const: http
type: string
required:
- type
- method
type: object
output:
properties:
type:
type: string
required:
- type
type: object
required:
- input
type: object
offer-receipt:
info:
offers:
- acceptIndex: 0
format: jws
signature: eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6Y3NvYWkub3JnI2JvYXJkLWF0dGVzdGF0aW9uLTEifQ.eyJhbW91bnQiOiIwIiwiYXNzZXQiOiIweDgzMzU4OWZDRDZlRGI2RTA4ZjRjN0MzMkQ0ZjcxYjU0YmRBMDI5MTMiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJwYXlUbyI6IjB4MjEyNjg2NDA0QTdEMUUxZkQ4OEYzNWVENjIwMGMzYUY3QTc4YWUzMSIsInJlc291cmNlVXJsIjoiaHR0cHM6Ly9jb3VuY2lsb2YuYWkvYXBpL2ZyZWUtZG9vciIsInNjaGVtZSI6ImV4YWN0IiwidmFsaWRVbnRpbCI6MTc5MDU3MjQ4OCwidmVyc2lvbiI6MX0.Lx5NQC7JvuiAjMGPN2dzpKJjAG3Gcrme36Wuv1rMaPTrRhIKEdJvWEN5jb-5ra3FLUZvKZ6Y3xaHu68Z7jKdAg
schema:
$schema: https://json-schema.org/draft/2020-12/schema
properties:
offers:
items:
properties:
acceptIndex:
type: integer
format:
const: jws
type: string
signature:
description: JWS compact serialization containing the offer payload
type: string
required:
- format
- signature
type: object
type: array
required:
- offers
type: object
resource:
description: 'Live board totals and the signed public root, free: the axis totals and Merkle root, served through a real x402 settle. It reads nothing new: the totals are the board''s own and the root is the published one. States: each axis MEASURED or UNMEASURED exactly as the board states it. Verification is free forever; the same bytes answer 200 at /api/gspc and /root.json.'
mimeType: application/json
serviceName: CSOAI Free Door
url: https://councilof.ai/api/free-door
x402Version: 2
schema:
$ref: '#/components/schemas/X402PaymentRequired'
description: 'Payment required — the x402 v2 challenge. The PAYMENT-REQUIRED response header carries its minimal v2 subset (x402Version, error, resource, accepts[] payment fields); extensions and the csoai sidecar are in this body only. Pay accepts[0] (scheme exact, network eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31; amount in atomic units) and retry the same request with the X-PAYMENT header. Verification of the artefact stays free. The example is a captured challenge: its amount and any csoai_pricing dates are as captured, not a standing price. Amounts are set per request in the challenge and can change, so read accepts[] from a live 402 on every call.'
headers:
PAYMENT-REQUIRED:
description: 'base64(JSON) of the minimal v2 PaymentRequired: x402Version, error, resource, accepts[] (scheme, network, amount, asset, payTo, maxTimeoutSeconds, extra) — under 4 KiB'
schema:
type: string
summary: Free board + public-root discovery door
tags:
- free
x-csoai:
challenge:
amount_source: captured live 402 (challenges/free_door.json)
captured: true
payment_required_header_bytes: 1864
door: https://councilof.ai/api/free-door
free_preview: https://councilof.ai/api/free-door
never:
- a paid artefact
- a grade
- a rank
- a certificate
paid_for: null
tier: free_door
x-payment-info:
protocols:
- x402
components:
schemas:
X402Accept:
properties:
amount:
description: atomic units (x402 v2)
pattern: ^[0-9]+$
type: string
asset:
const: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
description: USDC contract, 6 decimals
type: string
extra:
description: EIP-712 domain of the asset
properties:
name:
type: string
version:
type: string
type: object
maxAmountRequired:
description: atomic units (x402 v1 name for the same figure)
pattern: ^[0-9]+$
type: string
maxTimeoutSeconds:
type: integer
network:
const: eip155:8453
description: CAIP-2
type: string
payTo:
const: '0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31'
type: string
scheme:
const: exact
type: string
required:
- scheme
- network
- asset
- payTo
- amount
- maxTimeoutSeconds
type: object
X402PaymentRequired:
properties:
accepts:
items:
$ref: '#/components/schemas/X402Accept'
minItems: 1
type: array
error:
type: string
extensions:
description: extensions.bazaar carries info.input (a sample request) and schema (input/output JSON Schema). extensions['offer-receipt'].info.offers[] carries one server-signed offer per accepts[] entry, format 'jws' — a compact EdDSA JWS whose payload is the offer (x402 Offer & Receipt extension §4.1). It is present only when the edge holds its signing key; csoai.offer_receipt.signed says which, and why, on every 402.
properties:
offer-receipt:
properties:
info:
properties:
offers:
items:
properties:
acceptIndex:
description: unsigned convenience field; match offers to accepts[] by payload fields, never by index (§4.1.1)
type: integer
format:
const: jws
type: string
signature:
description: JWS compact serialization containing the offer payload
type: string
required:
- format
- signature
type: object
type: array
type: object
type: object
type: object
resource:
properties:
description:
type: string
mimeType:
type: string
serviceName:
type: string
tags:
items:
type: string
type: array
url:
type: string
type: object
x402Version:
const: 2
type: integer
required:
- x402Version
- accepts
type: object
securitySchemes:
ed25519:
description: Ed25519 signature of canonical body, under did:web:csoai.org#card-attestation-1
in: header
name: X-CSOAI-Signed-Card
type: apiKey
githubOidc:
bearerFormat: JWT
description: GitHub Actions OIDC token satisfying the handler's issuer, audience, repository and workflow checks.
scheme: bearer
type: http
operatorBearer:
description: Operation-specific configured operator or writer credential. Not interchangeable across operations.
scheme: bearer
type: http
x-x402:
amounts: only inside each resource's 402 challenge (accepts[].amount) — never on this catalog, never in prose
asset:
contract: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
decimals: 6
symbol: USDC
catalog: https://councilof.ai/api/x402
doors:
- /api/free-door
- /api/discover/chainlink
- /api/discover/ondo
- /api/discover/ondo-ousg
- /api/request-attestation
- /api/evidence-bundle
- /api/signed-data-feed
- /api/proof
- /api/rwa/evidence
- /api/wrapper
- /api/wrapper/changes
- /api/wrapper/asset/usdc
- /api/wrapper/asset/usdt
- /api/wrapper/asset/dai
- /api/art50/marking-evidence
- /api/feeds/provider-diff
- /api/receipts/batch
- /api/measurement/fresh-capsule
- /api/pop/stablecoins
- /api/pop/swift
- /api/pop/xrpl
- /api/pop/x402-bazaar
- /api/pop/mcp-registry
- /api/pop/a2a
- /api/pop/ots-proofs
- /api/pop/layer0
- /api/pop/corrections
- /api/pop/claim-watch
- /api/ras/mcp-probe
- /api/ras/x402-check
- /api/ras/supply
facilitator:
configured: true
note: the facilitator URL is a Cloudflare Pages env var (X402_FACILITATOR_URL) that no public surface publishes; /api/x402 reports only whether one is configured
url: null
mcp: https://councilof.ai/mcp
mode: live
mode_note: A settled receipt (facilitator /verify then /settle) unlocks the paid artefact. Verification of every artefact stays free.
network: eip155:8453
not:
- score
- certificate
- filled-cells
- pay-to-pass
- rank
offer_receipt:
alg: EdDSA
did_document: https://csoai.org/.well-known/did.json
formats_emitted:
- jws
formats_not_emitted:
- eip712
kid: did:web:csoai.org#board-attestation-1
receipts_by_payer: https://councilof.ai/api/receipts?payer=0x…
spec: https://github.com/x402-foundation/x402/blob/69652a69798f0b08f95bef33318896e36e210f7e/specs/extensions/extension-offer-and-receipt.md
spec_commit: 69652a69798f0b08f95bef33318896e36e210f7e
supported: true
verify_hosted: https://councilof.ai/api/receipts/verify
verify_offline: https://councilof.ai/verifier/verify_receipt.py
why_no_eip712: the edge holds one Ed25519 signing key (a Cloudflare Pages secret) and no secp256k1 signer; eip712 would require a key nobody has provisioned, so we emit none rather than a format we cannot produce
payTo: '0x212686404A7D1E1fD88F35eD6200c3aF7A78ae31'
public_operations: 120
quarantined:
- buyable: false
free_status: https://councilof.ai/api/witness/status?sha256=<64-hex>
lifecycle: QUARANTINED_PRE_RELEASE
reason: paid witness issuance is disabled until a release gate verifies leaf → signed root → sidecar → Rekor → OpenTimestamps
url: https://councilof.ai/api/witness?sha256=<64-hex>
revenue_truth: https://councilof.ai/api/revenue
schema_of_source:
catalog: csoai.x402-catalog/0.3
well_known: csoai.x402/0.2
scheme: exact
unauthenticated_facades: 42
well_known: https://councilof.ai/.well-known/x402.json
x-provenance:
method: harvested
publisher: Council of AI
source: https://councilof.ai/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)