{"openapi":"3.1.0","info":{"title":"RunOnProof","version":"3.0.0","description":"Verifiable business authorization infrastructure for AI agents and enterprise systems."},"servers":[{"url":"https://cdo-production.up.railway.app"}],"paths":{"/v1/rates":{"get":{"summary":"Brazilian macro rates: SELIC policy target rate, CDI, IPCA 12-month inflation, IGP-M, TR, plus Focus market survey expec","description":"Brazilian macro rates: SELIC policy target rate, CDI, IPCA 12-month inflation, IGP-M, TR, plus Focus market survey expectations (year-end SELIC and IPCA). Source: Brazilian Central Bank (SGS and Focus/Expectativas open APIs).\n\nPaid: $0.002 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_rates","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"selic":{"type":"object","description":"SELIC policy target rate, % per year","properties":{"value":{"type":"number"},"reference":{"type":"string"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"cdi":{"type":"object","description":"CDI daily rate, % per day","properties":{"value":{"type":"number"},"reference":{"type":"string"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"ipca_12m":{"type":"object","description":"IPCA accumulated 12 months, %","properties":{"value":{"type":"number"},"reference":{"type":"string"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"igpm":{"type":"object","description":"IGP-M monthly variation, %","properties":{"value":{"type":"number"},"reference":{"type":"string"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"tr":{"type":"object","description":"TR (referential rate), %","properties":{"value":{"type":"number"},"reference":{"type":"string"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"focus":{"type":"object","description":"Focus market survey median expectations for the current year end","properties":{"selic_year_end":{"type":"object","properties":{"value":{"type":"number"},"year":{"type":"integer"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"ipca_year_end":{"type":"object","properties":{"value":{"type":"number"},"year":{"type":"integer"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"selic":{"value":15,"reference":"2026-07-10","as_of":"2026-07-10T00:00:00Z","stale":false},"cdi":{"value":0.054266,"reference":"2026-07-10","as_of":"2026-07-10T00:00:00Z","stale":false},"ipca_12m":{"value":5.35,"reference":"2026-06","as_of":"2026-06-30T00:00:00Z","stale":false},"igpm":{"value":-0.5,"reference":"2026-06","as_of":"2026-06-30T00:00:00Z","stale":false},"tr":{"value":0.0844,"reference":"2026-07-10","as_of":"2026-07-10T00:00:00Z","stale":false},"focus":{"selic_year_end":{"value":15,"year":2026,"as_of":"2026-07-04T00:00:00Z","stale":false},"ipca_year_end":{"value":5.2,"year":2026,"as_of":"2026-07-04T00:00:00Z","stale":false}},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.002,"charged_price_usd":0.002,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/b3/{ticker}":{"get":{"summary":"B3 (Brazilian stock exchange) quote for stocks, REITs (FIIs) and ETFs by ticker (e.g. PETR4, VALE3, HGLG11, BOVA11). IMP","description":"B3 (Brazilian stock exchange) quote for stocks, REITs (FIIs) and ETFs by ticker (e.g. PETR4, VALE3, HGLG11, BOVA11). IMPORTANT: prices are DELAYED by approximately 15-30 minutes — this is not a real-time feed. Source: brapi.dev.\n\nPaid: $0.003 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_b3_quote","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string","description":"Company or fund long name"},"price":{"type":"number","description":"Last price in BRL — DELAYED ~15-30 minutes"},"change_pct":{"type":"number","description":"Daily change %"},"previous_close":{"type":"number"},"market_cap":{"type":["number","null"]},"volume":{"type":["number","null"]},"currency":{"type":"string"},"delayed":{"type":"boolean","description":"Always true: B3 data is delayed ~15-30 minutes"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"ticker":"PETR4","name":"Petrobras PN","price":38.42,"change_pct":1.13,"previous_close":37.99,"market_cap":500000000000,"volume":32000000,"currency":"BRL","delayed":true,"as_of":"2026-07-10T17:45:00Z","stale":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.003,"charged_price_usd":0.003,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/titulos":{"get":{"summary":"Tesouro Direto (Brazilian federal government retail bonds): current rate and unit price for every bond available for pur","description":"Tesouro Direto (Brazilian federal government retail bonds): current rate and unit price for every bond available for purchase — inflation-linked (IPCA+), fixed rate (Prefixado) and floating (Selic). Source: Tesouro Transparente official dataset.\n\nPaid: $0.003 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_titulos","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"titulos":{"type":"array","items":{"type":"object","properties":{"titulo":{"type":"string","description":"Bond name, e.g. 'Tesouro IPCA+ 2035'"},"vencimento":{"type":"string","format":"date","description":"Maturity date"},"taxa_compra":{"type":["number","null"],"description":"Annual buy rate, % (real rate for IPCA+ bonds)"},"preco_compra":{"type":["number","null"],"description":"Unit buy price in BRL"}}}},"count":{"type":"integer"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"titulos":[{"titulo":"Tesouro IPCA+ 2035","vencimento":"2035-05-15","taxa_compra":7.1,"preco_compra":2280.5},{"titulo":"Tesouro Prefixado 2029","vencimento":"2029-01-01","taxa_compra":13.9,"preco_compra":720.11}],"count":2,"as_of":"2026-07-10T15:00:00Z","stale":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.003,"charged_price_usd":0.003,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/cnpj/{cnpj}":{"get":{"summary":"Brazilian company registry data (Receita Federal) by CNPJ: legal name, trade name, registration status, CNAE activity co","description":"Brazilian company registry data (Receita Federal) by CNPJ: legal name, trade name, registration status, CNAE activity codes, partners/officers (QSA), address, share capital. Normalized JSON. Source: Receita Federal via BrasilAPI, cached up to 7 days.\n\nPaid: $0.005 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_cnpj","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string","description":"Normalized CNPJ (14 digits)"},"razao_social":{"type":"string","description":"Legal name"},"nome_fantasia":{"type":["string","null"],"description":"Trade name"},"situacao_cadastral":{"type":"string","description":"Registration status (e.g. ATIVA)"},"data_situacao_cadastral":{"type":["string","null"],"format":"date"},"data_inicio_atividade":{"type":["string","null"],"format":"date"},"cnae_principal":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"}}},"cnaes_secundarios":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"}}}},"natureza_juridica":{"type":["string","null"]},"capital_social":{"type":["number","null"]},"endereco":{"type":"object","properties":{"logradouro":{"type":["string","null"]},"numero":{"type":["string","null"]},"complemento":{"type":["string","null"]},"bairro":{"type":["string","null"]},"municipio":{"type":["string","null"]},"uf":{"type":["string","null"]},"cep":{"type":["string","null"]}}},"qsa":{"type":"array","description":"Partners and officers","items":{"type":"object","properties":{"nome":{"type":"string"},"qualificacao":{"type":["string","null"]},"data_entrada":{"type":["string","null"],"format":"date"}}}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"00000000000191","razao_social":"BANCO DO BRASIL SA","nome_fantasia":"BANCO DO BRASIL","situacao_cadastral":"ATIVA","data_situacao_cadastral":"2005-11-03","data_inicio_atividade":"1966-08-01","cnae_principal":{"codigo":"6422100","descricao":"Bancos múltiplos, com carteira comercial"},"cnaes_secundarios":[],"natureza_juridica":"Sociedade de Economia Mista","capital_social":120000000000,"endereco":{"logradouro":"SAUN QUADRA 5 LOTE B","numero":"SN","complemento":null,"bairro":"ASA NORTE","municipio":"BRASILIA","uf":"DF","cep":"70040912"},"qsa":[{"nome":"FULANO DE TAL","qualificacao":"Presidente","data_entrada":"2023-01-01"}],"as_of":"2026-07-08T12:00:00Z","stale":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.005,"charged_price_usd":0.005,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/sancoes/{cnpj}":{"get":{"summary":"Brazilian sanctions screening for companies (CNPJ ONLY — individuals/CPF are not supported by policy): CEIS (debarred co","description":"Brazilian sanctions screening for companies (CNPJ ONLY — individuals/CPF are not supported by policy): CEIS (debarred companies), CNEP (anti-corruption law penalties), leniency agreements, the 'dirty list' of employers caught using slave-like labor (MTE), and TCU debarred bidders. Returns per-list hits with details. Sources: Portal da Transparência API, MTE public list, TCU open data.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_sancoes","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"clean":{"type":"boolean","description":"True when no list returned any hit"},"lists":{"type":"object","properties":{"ceis":{"type":"object","properties":{"hits":{"type":"integer"},"records":{"type":"array","items":{"type":"object"}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"cnep":{"type":"object","properties":{"hits":{"type":"integer"},"records":{"type":"array","items":{"type":"object"}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"acordos_leniencia":{"type":"object","properties":{"hits":{"type":"integer"},"records":{"type":"array","items":{"type":"object"}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"trabalho_escravo":{"type":"object","properties":{"hits":{"type":"integer"},"records":{"type":"array","items":{"type":"object"}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}},"tcu_inidoneos":{"type":"object","properties":{"hits":{"type":"integer"},"records":{"type":"array","items":{"type":"object"}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"}}}}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"00000000000191","clean":true,"lists":{"ceis":{"hits":0,"records":[],"as_of":"2026-07-10T00:00:00Z","stale":false},"cnep":{"hits":0,"records":[],"as_of":"2026-07-10T00:00:00Z","stale":false},"acordos_leniencia":{"hits":0,"records":[],"as_of":"2026-07-10T00:00:00Z","stale":false},"trabalho_escravo":{"hits":0,"records":[],"as_of":"2026-07-01T00:00:00Z","stale":false},"tcu_inidoneos":{"hits":0,"records":[],"as_of":"2026-07-01T00:00:00Z","stale":false}},"as_of":"2026-07-10T00:00:00Z","stale":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/processos/{cnpj}":{"get":{"summary":"Brazilian lawsuit metadata for a company (CNPJ ONLY): case counts, courts (tribunais), case classes and filing dates, ag","description":"Brazilian lawsuit metadata for a company (CNPJ ONLY): case counts, courts (tribunais), case classes and filing dates, aggregated from DataJud — the national judiciary open database (CNJ). Metadata only; full case documents are not returned. Cached up to 24h.\n\nPaid: $0.02 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_processos","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"total_processos":{"type":"integer","description":"Total cases found across searched courts"},"tribunais":{"type":"array","items":{"type":"object","properties":{"tribunal":{"type":"string"},"count":{"type":"integer"}}}},"classes":{"type":"array","items":{"type":"object","properties":{"classe":{"type":"string"},"count":{"type":"integer"}}}},"date_range":{"type":"object","properties":{"oldest":{"type":["string","null"],"format":"date"},"newest":{"type":["string","null"],"format":"date"}}},"tribunais_searched":{"type":"array","items":{"type":"string"},"description":"Courts actually queried in this response"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"00000000000191","total_processos":1240,"tribunais":[{"tribunal":"TJSP","count":800},{"tribunal":"TRF1","count":440}],"classes":[{"classe":"Procedimento Comum Cível","count":512}],"date_range":{"oldest":"2001-03-12","newest":"2026-06-30"},"tribunais_searched":["TJSP","TJRJ","TRF1"],"as_of":"2026-07-10T10:00:00Z","stale":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.02,"charged_price_usd":0.02,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/clima/{cidade}":{"get":{"summary":"Current weather, 3-day forecast, UV index and air quality for any Brazilian city (geocoding included — pass the city nam","description":"Current weather, 3-day forecast, UV index and air quality for any Brazilian city (geocoding included — pass the city name, e.g. 'sao-paulo', 'rio-de-janeiro', 'belo-horizonte'). Source: Open-Meteo (forecast, air quality and geocoding APIs). Cached 30 minutes per city.\n\nPaid: $0.001 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_clima","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"object","properties":{"name":{"type":"string"},"state":{"type":["string","null"]},"latitude":{"type":"number"},"longitude":{"type":"number"}}},"current":{"type":"object","properties":{"temperature_c":{"type":"number"},"humidity_pct":{"type":"number"},"wind_speed_kmh":{"type":"number"},"precipitation_mm":{"type":"number"},"weather_code":{"type":"integer","description":"WMO weather code"}}},"forecast_3d":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"temp_min_c":{"type":"number"},"temp_max_c":{"type":"number"},"precipitation_mm":{"type":"number"},"uv_index_max":{"type":"number"}}}},"air_quality":{"type":"object","properties":{"aqi_us":{"type":["number","null"],"description":"US AQI"},"pm2_5":{"type":["number","null"],"description":"PM2.5 µg/m³"},"pm10":{"type":["number","null"],"description":"PM10 µg/m³"}}},"uv_index_now":{"type":["number","null"]},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data is older than the source freshness limit (should not happen: stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"city":{"name":"São Paulo","state":"São Paulo","latitude":-23.55,"longitude":-46.63},"current":{"temperature_c":18.4,"humidity_pct":72,"wind_speed_kmh":9.7,"precipitation_mm":0,"weather_code":3},"forecast_3d":[{"date":"2026-07-11","temp_min_c":12.1,"temp_max_c":22.3,"precipitation_mm":0,"uv_index_max":5.2}],"air_quality":{"aqi_us":42,"pm2_5":9.1,"pm10":18.2},"uv_index_now":3.1,"as_of":"2026-07-10T18:00:00Z","stale":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.001,"charged_price_usd":0.001,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/company/profile/{cnpj}":{"get":{"summary":"Retrieve a normalized Brazilian company profile for entity verification and vendor onboarding. Includes official registr","description":"Retrieve a normalized Brazilian company profile for entity verification and vendor onboarding. Includes official registration status, legal and trade names, headquarters or branch indicator, opening date, company age, legal nature, business activities, address, declared capital, contact fields when lawfully available, ownership data when available, source coverage and freshness. Accepts CNPJ only.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_company_profile","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"root_cnpj":{"type":"string"},"valid":{"type":"boolean"},"legal_name":{"type":["string","null"]},"trade_name":{"type":["string","null"]},"registration_status":{"type":"string","enum":["active","suspended","unfit","closed","null","special","unknown"]},"registration_status_original":{"type":["string","null"]},"registration_status_date":{"type":["string","null"],"format":"date"},"headquarters_or_branch":{"type":"string","enum":["headquarters","branch","unknown"]},"opening_date":{"type":["string","null"],"format":"date"},"company_age_days":{"type":["number","null"]},"legal_nature":{"type":"object","properties":{"code":{"type":["string","null"]},"description":{"type":["string","null"]}}},"size":{"type":["string","null"]},"declared_capital_brl":{"type":["string","null"]},"primary_activity":{"type":["object","null"],"properties":{"code":{"type":"string"},"description":{"type":"string"}}},"secondary_activities":{"type":"array","items":{"type":"object"}},"address":{"type":["object","null"]},"owners":{"type":"array","description":"Ownership (QSA); natural-person names are masked by default","items":{"type":"object"}},"field_provenance":{"type":"object","description":"Which provider produced each field group"},"coverage":{"type":"array","description":"Per-source coverage: which sources were consulted, their execution status and scope. 'not_available'/'source_unavailable' mean the source could not be checked — the result is unknown, not clear.","items":{"type":"object","properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"status":{"type":"string","enum":["completed","partial","not_available","source_unavailable","source_stale","not_applicable","invalid_input"]},"scope":{"type":["string","null"]},"data_as_of":{"type":["string","null"],"format":"date-time"},"note":{"type":["string","null"]}}}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data exceeded its source freshness limit (stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"11222333000181","root_cnpj":"11222333","valid":true,"legal_name":"ACME INDUSTRIA E COMERCIO LTDA","trade_name":"ACME","registration_status":"active","headquarters_or_branch":"headquarters","company_age_days":4200,"as_of":"2026-07-10T12:00:00Z","stale":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/company/tax-regime/{cnpj}":{"get":{"summary":"Check available Brazilian company tax-regime indicators for onboarding and invoicing workflows, including Simples Nacion","description":"Check available Brazilian company tax-regime indicators for onboarding and invoicing workflows, including Simples Nacional and MEI status when lawfully accessible through configured official or licensed sources. Returns source coverage, effective dates and explicit unknown states when an automated source is unavailable. Accepts CNPJ only.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_company_tax_regime","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"status":{"type":"string","enum":["completed","partial","not_available","source_unavailable"]},"simples_nacional":{"type":["boolean","null"],"description":"null = unknown (no lawful automated source); never fabricated as false"},"mei":{"type":["boolean","null"]},"coverage":{"type":"array","description":"Per-source coverage: which sources were consulted, their execution status and scope. 'not_available'/'source_unavailable' mean the source could not be checked — the result is unknown, not clear.","items":{"type":"object","properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"status":{"type":"string","enum":["completed","partial","not_available","source_unavailable","source_stale","not_applicable","invalid_input"]},"scope":{"type":["string","null"]},"data_as_of":{"type":["string","null"],"format":"date-time"},"note":{"type":["string","null"]}}}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data exceeded its source freshness limit (stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"11222333000181","status":"not_available","simples_nacional":null,"mei":null,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/company/state-registrations/{cnpj}":{"get":{"summary":"Retrieve available Brazilian state tax-registration records associated with a CNPJ for supplier onboarding and invoicing","description":"Retrieve available Brazilian state tax-registration records associated with a CNPJ for supplier onboarding and invoicing validation. Returns registration numbers, states, status, source, coverage and freshness. Coverage varies by state and unavailable jurisdictions are explicitly reported. Accepts CNPJ only.\n\nPaid: $0.015 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_company_state_registrations","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"status":{"type":"string"},"registrations":{"type":"array","items":{"type":"object","properties":{"state":{"type":"string"},"registration_number":{"type":["string","null"]},"status":{"type":["string","null"]}}}},"states_covered":{"type":"array","items":{"type":"string"}},"states_unavailable":{"type":"array","items":{"type":"string"}},"coverage":{"type":"array","description":"Per-source coverage: which sources were consulted, their execution status and scope. 'not_available'/'source_unavailable' mean the source could not be checked — the result is unknown, not clear.","items":{"type":"object","properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"status":{"type":"string","enum":["completed","partial","not_available","source_unavailable","source_stale","not_applicable","invalid_input"]},"scope":{"type":["string","null"]},"data_as_of":{"type":["string","null"],"format":"date-time"},"note":{"type":["string","null"]}}}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data exceeded its source freshness limit (stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"11222333000181","status":"not_available","registrations":[],"states_covered":[],"states_unavailable":["ALL"],"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.015,"charged_price_usd":0.015,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/company/certificates/{cnpj}":{"get":{"summary":"Retrieve machine-verifiable Brazilian company clearance-certificate metadata from configured official or licensed source","description":"Retrieve machine-verifiable Brazilian company clearance-certificate metadata from configured official or licensed sources. Returns certificate type, issuer, status, issue date, expiry date, verification reference and source coverage. Does not bypass CAPTCHA or restricted government portals. Accepts CNPJ only.\n\nPaid: $0.02 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_company_certificates","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"certificate_type":{"type":"string"},"issuer":{"type":"string"},"status":{"type":"string"},"issued_at":{"type":["string","null"]},"expires_at":{"type":["string","null"]}}}},"coverage":{"type":"array","description":"Per-source coverage: which sources were consulted, their execution status and scope. 'not_available'/'source_unavailable' mean the source could not be checked — the result is unknown, not clear.","items":{"type":"object","properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"status":{"type":"string","enum":["completed","partial","not_available","source_unavailable","source_stale","not_applicable","invalid_input"]},"scope":{"type":["string","null"]},"data_as_of":{"type":["string","null"],"format":"date-time"},"note":{"type":["string","null"]}}}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data exceeded its source freshness limit (stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"11222333000181","status":"not_available","items":[],"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.02,"charged_price_usd":0.02,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/company/litigation/{cnpj}":{"get":{"summary":"Retrieve public Brazilian court-case metadata associated with a company CNPJ for preliminary litigation-risk review. Ret","description":"Retrieve public Brazilian court-case metadata associated with a company CNPJ for preliminary litigation-risk review. Returns counts, courts, jurisdictions, classes, subjects, filing periods, recent activity and coverage limitations. Metadata does not establish liability, case outcome or wrongdoing. Accepts CNPJ only.\n\nPaid: $0.02 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_company_litigation","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"status":{"type":"string"},"total_cases":{"type":["number","null"]},"by_court":{"type":"array","items":{"type":"object"}},"by_jurisdiction":{"type":"array","items":{"type":"object"}},"by_class":{"type":"array","items":{"type":"object"}},"by_subject":{"type":"array","items":{"type":"object"}},"by_year":{"type":"array","items":{"type":"object"}},"recent_cases":{"type":"array","items":{"type":"object"}},"oldest_filing_date":{"type":["string","null"]},"newest_filing_date":{"type":["string","null"]},"possible_duplicates":{"type":"boolean"},"partial_results":{"type":"boolean"},"coverage":{"type":"array","description":"Per-source coverage: which sources were consulted, their execution status and scope. 'not_available'/'source_unavailable' mean the source could not be checked — the result is unknown, not clear.","items":{"type":"object","properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"status":{"type":"string","enum":["completed","partial","not_available","source_unavailable","source_stale","not_applicable","invalid_input"]},"scope":{"type":["string","null"]},"data_as_of":{"type":["string","null"],"format":"date-time"},"note":{"type":["string","null"]}}}},"limitations":{"type":"array","items":{"type":"string"}},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data exceeded its source freshness limit (stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"11222333000181","status":"completed","total_cases":12,"by_court":[{"key":"TJSP","count":8}],"partial_results":true,"limitations":["Only a subset of courts is queried; counts are a lower bound and do not establish liability."],"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.02,"charged_price_usd":0.02,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/company/integrity/{cnpj}":{"get":{"summary":"Retrieve source-by-source Brazilian corporate integrity and sanctions results for a CNPJ. Includes CEIS, CNEP, leniency ","description":"Retrieve source-by-source Brazilian corporate integrity and sanctions results for a CNPJ. Includes CEIS, CNEP, leniency agreements, TCU debarment records and forced-labor employer records when available, with exact-match logic, potential-match warnings, evidence, dates and coverage. A clear result only means no match was found in the successfully completed sources. Accepts CNPJ only.\n\nPaid: $0.015 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_company_integrity","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string"},"outcome":{"type":"string","enum":["no_matches_found","potential_match","confirmed_match","incomplete_screening"]},"exact_matches":{"type":"number"},"potential_matches":{"type":"number"},"checks":{"type":"object"},"matches":{"type":"array","items":{"type":"object"}},"coverage":{"type":"array","description":"Per-source coverage: which sources were consulted, their execution status and scope. 'not_available'/'source_unavailable' mean the source could not be checked — the result is unknown, not clear.","items":{"type":"object","properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"status":{"type":"string","enum":["completed","partial","not_available","source_unavailable","source_stale","not_applicable","invalid_input"]},"scope":{"type":["string","null"]},"data_as_of":{"type":["string","null"],"format":"date-time"},"note":{"type":["string","null"]}}}},"requires_human_review":{"type":"boolean"},"as_of":{"type":"string","format":"date-time","description":"Timestamp of the underlying source data (UTC ISO 8601)"},"stale":{"type":"boolean","description":"True if the data exceeded its source freshness limit (stale sources return HTTP 503 instead)"},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"cnpj":"11222333000181","outcome":"no_matches_found","exact_matches":0,"potential_matches":0,"requires_human_review":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.015,"charged_price_usd":0.015,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/dossiers/br/basic/{cnpj}":{"get":{"summary":"Verify whether a Brazilian company exists and is operational before creating a vendor, customer or payment record. Retur","description":"Verify whether a Brazilian company exists and is operational before creating a vendor, customer or payment record. Returns normalized official registration data, legal status, company age, headquarters or branch status, business activities, address, declared capital, ownership information when available, tax-regime indicators when available, freshness, coverage and machine-actionable onboarding signals. Accepts Brazilian CNPJ only.\n\nPaid: $0.03 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_dossier_basic","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.dossier.basic.output","type":"object","description":"BrazilCompanyBasicCheck — official registration facts, checks, consistency signals, onboarding assessment, coverage, evidence, freshness.","required":["product","entity","onboarding_assessment","coverage","evidence","freshness"],"additionalProperties":true,"properties":{"product":{"type":"object","required":["id","name","price_usdc"],"properties":{"id":{"type":"string","const":"br_company_basic_v1"},"name":{"type":"string","const":"Brazil Company Basic Check"},"price_usdc":{"type":"string","description":"USDC price as a decimal string (x402 amount)."},"schema_version":{"type":"string"},"assessment_model_version":{"type":"string"}},"additionalProperties":true},"entity":{"type":"object","required":["cnpj","valid"],"properties":{"cnpj":{"type":"string"},"valid":{"type":"boolean"},"registration_status":{"type":["string","null"]},"headquarters_or_branch":{"type":["string","null"]}},"additionalProperties":true},"onboarding_assessment":{"type":"object","required":["outcome"],"properties":{"outcome":{"type":"string","enum":["proceed","proceed_with_controls","review","do_not_proceed","unknown"]},"confidence":{"type":["number","null"],"minimum":0,"maximum":1}},"additionalProperties":true},"coverage":{"type":"object","description":"Weighted coverage of the product's required components (0–100).","required":["coverage_percentage"],"properties":{"coverage_percentage":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":true},"evidence":{"type":"array","description":"Traceable evidence references (ids + sources). Absence of evidence is never a negative confirmation.","items":{"type":"object","additionalProperties":true}},"freshness":{"type":"object","required":["generated_at"],"properties":{"generated_at":{"type":"string","format":"date-time"}},"additionalProperties":true},"enterprise":{"type":["object","null"],"description":"Enterprise Decision Layer (identity_trust, risk_engine, beneficial_ownership, network_graph, evidence_bundle, decision_engine). Additive, backward-compatible.","additionalProperties":true},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"product":{"id":"br_company_basic_v1","name":"Brazil Company Basic Check","price_usdc":"0.030"},"entity":{"cnpj":"11222333000181","valid":true,"registration_status":"active","headquarters_or_branch":"headquarters"},"onboarding_assessment":{"outcome":"proceed","confidence":0.9},"coverage":{"coverage_percentage":100},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.03,"charged_price_usd":0.03,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"purpose":{"type":"string","enum":["vendor_onboarding","customer_onboarding","payment_approval","procurement","credit","partnership","general_due_diligence"],"default":"general_due_diligence","description":"The decision the agent is trying to make. Changes recommendations (never the facts)."},"transaction_value_brl":{"type":"number","description":"Intended transaction value in BRL. High values with incomplete coverage escalate to human review."},"counterparty_role":{"type":"string","enum":["supplier","customer","payee","partner","borrower","other"],"default":"other"},"max_data_age_minutes":{"type":"integer","description":"Optional stricter freshness bound; components older than this are treated as stale."},"include_evidence":{"type":"boolean","default":true,"description":"Include the per-fact evidence array (source, timestamp, content hash)."},"language":{"type":"string","enum":["en","pt-BR"],"default":"en","description":"Human-readable message language. JSON field names remain English."}}}}}}}},"/v1/dossiers/br/compliance/{cnpj}":{"get":{"summary":"Screen a Brazilian legal entity before contracting, onboarding or paying it. Checks official Brazilian sanctions and int","description":"Screen a Brazilian legal entity before contracting, onboarding or paying it. Checks official Brazilian sanctions and integrity sources, including CEIS, CNEP, leniency agreements, TCU debarment data and the employers' forced-labor registry when available. Returns exact and potential matches, source-by-source execution status, evidence, freshness, coverage, match confidence and machine-actionable escalation guidance. Accepts CNPJ only.\n\nPaid: $0.1 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_dossier_compliance","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.dossier.compliance.output","type":"object","description":"BrazilComplianceScreening — screening summary, per-source checks, matches, coverage, evidence, freshness. A 'clear' result means no match in the successfully completed sources only.","required":["product","screening_summary","coverage","evidence","freshness"],"additionalProperties":true,"properties":{"product":{"type":"object","required":["id","name","price_usdc"],"properties":{"id":{"type":"string","const":"br_compliance_screening_v1"},"name":{"type":"string","const":"Brazil Compliance Screening"},"price_usdc":{"type":"string","description":"USDC price as a decimal string (x402 amount)."},"schema_version":{"type":"string"},"assessment_model_version":{"type":"string"}},"additionalProperties":true},"entity_identity":{"type":"object","properties":{"cnpj":{"type":"string"},"legal_name":{"type":["string","null"]},"registration_status":{"type":"string"},"headquarters_or_branch":{"type":"string"}},"additionalProperties":true},"screening_summary":{"type":"object","required":["outcome"],"properties":{"outcome":{"type":"string","enum":["no_matches_found","potential_matches_found","matches_found","incomplete","unknown"]},"completed_sources":{"type":"integer","minimum":0},"total_expected_sources":{"type":"integer","minimum":0},"requires_human_review":{"type":"boolean"}},"additionalProperties":true},"source_status":{"type":"object","description":"Per-source operational state. Legacy mte/tcu string aliases are retained for compatibility.","required":["mte","tcu","mte_trabalho_escravo","tcu_inidoneos"],"properties":{"mte":{"type":"string","enum":["fresh","stale","unavailable"]},"tcu":{"type":"string","enum":["fresh","stale","unavailable"]},"mte_trabalho_escravo":{"type":"object","required":["status","reason_code"],"properties":{"status":{"type":"string","enum":["fresh","stale","unavailable"]},"reason_code":{"type":["string","null"],"description":"Sanitized stable machine code; never an internal message or URL."}},"additionalProperties":false},"tcu_inidoneos":{"type":"object","required":["status","reason_code"],"properties":{"status":{"type":"string","enum":["fresh","stale","unavailable"]},"reason_code":{"type":["string","null"],"description":"Sanitized stable machine code; never an internal message or URL."}},"additionalProperties":false}},"additionalProperties":true},"coverage":{"type":"object","description":"Weighted coverage of the product's required components (0–100).","required":["coverage_percentage"],"properties":{"coverage_percentage":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":true},"evidence":{"type":"array","description":"Traceable evidence references (ids + sources). Absence of evidence is never a negative confirmation.","items":{"type":"object","additionalProperties":true}},"freshness":{"type":"object","required":["generated_at"],"properties":{"generated_at":{"type":"string","format":"date-time"}},"additionalProperties":true},"enterprise":{"type":["object","null"],"description":"Enterprise Decision Layer (identity_trust, risk_engine, beneficial_ownership, network_graph, evidence_bundle, decision_engine). Additive, backward-compatible.","additionalProperties":true},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"product":{"id":"br_compliance_screening_v1","name":"Brazil Compliance Screening","price_usdc":"0.100"},"screening_summary":{"outcome":"no_matches_found","completed_sources":5,"total_expected_sources":5,"requires_human_review":false},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.1,"charged_price_usd":0.1,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"purpose":{"type":"string","enum":["vendor_onboarding","customer_onboarding","payment_approval","procurement","credit","partnership","general_due_diligence"],"default":"general_due_diligence","description":"The decision the agent is trying to make. Changes recommendations (never the facts)."},"transaction_value_brl":{"type":"number","description":"Intended transaction value in BRL. High values with incomplete coverage escalate to human review."},"counterparty_role":{"type":"string","enum":["supplier","customer","payee","partner","borrower","other"],"default":"other"},"max_data_age_minutes":{"type":"integer","description":"Optional stricter freshness bound; components older than this are treated as stale."},"include_evidence":{"type":"boolean","default":true,"description":"Include the per-fact evidence array (source, timestamp, content hash)."},"language":{"type":"string","enum":["en","pt-BR"],"default":"en","description":"Human-readable message language. JSON field names remain English."}}}}}}}},"/v1/dossiers/br/full/{cnpj}":{"get":{"summary":"Perform a consolidated due diligence check on a Brazilian company before a material commercial decision. Combines offici","description":"Perform a consolidated due diligence check on a Brazilian company before a material commercial decision. Combines official registration, ownership, business activity, sanctions and integrity screening, public court metadata, company consistency checks, coverage analysis, explainable risk signals and decision-support recommendations. Returns facts separately from interpretations, exposes every source and timestamp, and flags incomplete coverage instead of treating unavailable data as clear. Accepts CNPJ only.\n\nPaid: $0.25 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_dossier_full","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.dossier.full.output","type":"object","description":"BrazilFullDueDiligence — executive summary, company profile, compliance, litigation, risk assessment, decision support, coverage, evidence, freshness. Facts are separated from interpretations; incomplete coverage is flagged, never treated as clear.","required":["product","executive_summary","company_profile","compliance","risk_assessment","decision_support","coverage","evidence","freshness"],"additionalProperties":true,"properties":{"product":{"type":"object","required":["id","name","price_usdc"],"properties":{"id":{"type":"string","const":"br_full_due_diligence_v1"},"name":{"type":"string","const":"Brazil Full Company Due Diligence"},"price_usdc":{"type":"string","description":"USDC price as a decimal string (x402 amount)."},"schema_version":{"type":"string"},"assessment_model_version":{"type":"string"}},"additionalProperties":true},"executive_summary":{"type":"object","required":["outcome"],"properties":{"entity_name":{"type":["string","null"]},"outcome":{"type":"string"},"risk_level":{"type":["string","null"]},"risk_score":{"type":["number","null"],"minimum":0,"maximum":100},"coverage_percentage":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":true},"company_profile":{"type":"object","additionalProperties":true,"description":"Embedded BrazilCompanyBasicCheck."},"compliance":{"type":"object","additionalProperties":true,"description":"Embedded BrazilComplianceScreening."},"source_status":{"type":"object","description":"Per-source operational state. Legacy mte/tcu string aliases are retained for compatibility.","required":["mte","tcu","mte_trabalho_escravo","tcu_inidoneos"],"properties":{"mte":{"type":"string","enum":["fresh","stale","unavailable"]},"tcu":{"type":"string","enum":["fresh","stale","unavailable"]},"mte_trabalho_escravo":{"type":"object","required":["status","reason_code"],"properties":{"status":{"type":"string","enum":["fresh","stale","unavailable"]},"reason_code":{"type":["string","null"],"description":"Sanitized stable machine code; never an internal message or URL."}},"additionalProperties":false},"tcu_inidoneos":{"type":"object","required":["status","reason_code"],"properties":{"status":{"type":"string","enum":["fresh","stale","unavailable"]},"reason_code":{"type":["string","null"],"description":"Sanitized stable machine code; never an internal message or URL."}},"additionalProperties":false}},"additionalProperties":true},"litigation":{"type":["object","null"],"additionalProperties":true},"certificates":{"type":["object","null"],"additionalProperties":true},"risk_assessment":{"type":"object","properties":{"risk_score":{"type":["number","null"],"minimum":0,"maximum":100},"risk_level":{"type":["string","null"]}},"additionalProperties":true},"decision_support":{"type":"object","properties":{"machine_action":{"type":"string"}},"additionalProperties":true},"coverage":{"type":"object","description":"Weighted coverage of the product's required components (0–100).","required":["coverage_percentage"],"properties":{"coverage_percentage":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":true},"evidence":{"type":"array","description":"Traceable evidence references (ids + sources). Absence of evidence is never a negative confirmation.","items":{"type":"object","additionalProperties":true}},"freshness":{"type":"object","required":["generated_at"],"properties":{"generated_at":{"type":"string","format":"date-time"}},"additionalProperties":true},"enterprise":{"type":["object","null"],"description":"Enterprise Decision Layer (identity_trust, risk_engine, beneficial_ownership, network_graph, evidence_bundle, decision_engine). Additive, backward-compatible.","additionalProperties":true},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}}},"example":{"product":{"id":"br_full_due_diligence_v1","name":"Brazil Full Company Due Diligence","price_usdc":"0.250","assessment_model_version":"br-risk-v1"},"executive_summary":{"outcome":"proceed_with_controls","risk_level":"moderate","risk_score":22,"coverage_percentage":90},"decision_support":{"machine_action":"allow_with_controls"},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.25,"charged_price_usd":0.25,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"purpose":{"type":"string","enum":["vendor_onboarding","customer_onboarding","payment_approval","procurement","credit","partnership","general_due_diligence"],"default":"general_due_diligence","description":"The decision the agent is trying to make. Changes recommendations (never the facts)."},"transaction_value_brl":{"type":"number","description":"Intended transaction value in BRL. High values with incomplete coverage escalate to human review."},"counterparty_role":{"type":"string","enum":["supplier","customer","payee","partner","borrower","other"],"default":"other"},"max_data_age_minutes":{"type":"integer","description":"Optional stricter freshness bound; components older than this are treated as stale."},"include_evidence":{"type":"boolean","default":true,"description":"Include the per-fact evidence array (source, timestamp, content hash)."},"language":{"type":"string","enum":["en","pt-BR"],"default":"en","description":"Human-readable message language. JSON field names remain English."}}}}}}}},"/v1/agent/corporate-decision/{cnpj}":{"get":{"summary":"Decide whether an agent may proceed with a supplier/customer/payment/onboarding/credit relationship with a Brazilian com","description":"Decide whether an agent may proceed with a supplier/customer/payment/onboarding/credit relationship with a Brazilian company. Returns decision, machine action, confidence, risk, structured reasoning, evidence and next actions. CNPJ only.\n\nPaid: $0.03 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_decision","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_decision","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.03,"actual_cost_usd":0.03},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.03,"charged_price_usd":0.03,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_decision. See example.","example":{"subject":{"cnpj":"11222333000181"},"decision_context":{"use_case":"SUPPLIER_ONBOARDING","transaction_value_usd":10000},"constraints":{"minimum_confidence":80}}}}}}}},"/v1/agent/corporate-evidence/{cnpj}":{"get":{"summary":"Return traceable evidence for claims about a Brazilian company (e.g. COMPANY_IS_ACTIVE, NO_SANCTIONS_FOUND, BENEFICIAL_O","description":"Return traceable evidence for claims about a Brazilian company (e.g. COMPANY_IS_ACTIVE, NO_SANCTIONS_FOUND, BENEFICIAL_OWNER_IDENTIFIED). Clearly reports when a claim cannot be proven; never converts absence of evidence into a negative confirmation. CNPJ only.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_evidence","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_evidence","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.01,"actual_cost_usd":0.01},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_evidence. See example.","example":{"subject":{"cnpj":"11222333000181"},"claims":["COMPANY_IS_ACTIVE","NO_SANCTIONS_FOUND","BENEFICIAL_OWNER_IDENTIFIED"]}}}}}}},"/v1/agent/corporate-trust-score/{cnpj}":{"get":{"summary":"Compact, auditable operational trust score for a Brazilian company across identity, registration, ownership transparency","description":"Compact, auditable operational trust score for a Brazilian company across identity, registration, ownership transparency, compliance, reputation, operational consistency and evidence quality. Distinct from risk score. CNPJ only.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_trust_score","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_trust_score","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.01,"actual_cost_usd":0.01},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_trust_score. See example.","example":{"subject":{"cnpj":"11222333000181"}}}}}}}},"/v1/agent/corporate-graph/{cnpj}":{"get":{"summary":"SINGLE-ENTITY corporate graph: maps ONE company's own owners, officers, address and contacts into nodes + edges with loc","description":"SINGLE-ENTITY corporate graph: maps ONE company's own owners, officers, address and contacts into nodes + edges with local risk propagation. Inferences are explicitly flagged. Does NOT discover other companies that share an owner/address — that requires the cross-company reverse index, which is disabled until backfilled. CNPJ only.\n\nPaid: $0.02 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_graph_intelligence","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_graph_intelligence","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.02,"actual_cost_usd":0.02},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.02,"charged_price_usd":0.02,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_graph_intelligence. See example.","example":{"subject":{"cnpj":"11222333000181"},"depth":2,"max_nodes":100}}}}}}},"/v1/agent/corporate-risk-reasoning/{cnpj}":{"get":{"summary":"Explain why a risk score or decision was produced, with drivers, rules triggered and counterfactuals. Exposes only verif","description":"Explain why a risk score or decision was produced, with drivers, rules triggered and counterfactuals. Exposes only verifiable justifications — never internal model chain-of-thought. CNPJ only.\n\nPaid: $0.015 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_risk_reasoning","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_risk_reasoning","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.015,"actual_cost_usd":0.015},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.015,"charged_price_usd":0.015,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_risk_reasoning. See example.","example":{"subject":{"cnpj":"11222333000181"},"target":"OVERALL_RISK"}}}}}}},"/v1/agent/corporate-entity-resolution":{"get":{"summary":"Determine whether two or more references point to the same Brazilian company. Exact CNPJ prevails over name similarity; ","description":"Determine whether two or more references point to the same Brazilian company. Exact CNPJ prevails over name similarity; entities are not auto-merged below the confidence threshold.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_entity_resolution","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_entity_resolution","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.01,"actual_cost_usd":0.01},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_entity_resolution. See example.","example":{"entities":[{"name":"Empresa Exemplo LTDA","cnpj":"11222333000181"},{"name":"Exemplo Tecnologia","domain":"exemplo.com.br"}]}}}}}}},"/v1/agent/corporate-identity/{cnpj}":{"get":{"summary":"Canonical, consolidated identity record for a Brazilian company (legal name, status, activities, address, ownership) wit","description":"Canonical, consolidated identity record for a Brazilian company (legal name, status, activities, address, ownership) with source precedence, conflicts and missing fields. CNPJ only.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_identity","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_identity","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.01,"actual_cost_usd":0.01},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_identity. See example.","example":{"cnpj":"11222333000181"}}}}}}},"/v1/agent/supplier-selection":{"get":{"summary":"Select the best available data supplier/capability for a required check considering cost, latency, quality, freshness, r","description":"Select the best available data supplier/capability for a required check considering cost, latency, quality, freshness, reputation and availability. Returns the selection plus fallback strategy. Availability reflects real configuration.\n\nPaid: $0.005 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_supplier_selection","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"supplier_selection","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.005,"actual_cost_usd":0.005},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.005,"charged_price_usd":0.005,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for supplier_selection. See example.","example":{"required_capability":"SANCTIONS_SCREENING","subject_country":"BR","constraints":{"max_cost_usd":0.02,"max_latency_ms":1500,"minimum_quality_score":90}}}}}}}},"/v1/agent/cost-optimizer/{cnpj}":{"get":{"summary":"Given a budget, latency and confidence target, decide which modules to execute, prioritizing information gain per unit c","description":"Given a budget, latency and confidence target, decide which modules to execute, prioritizing information gain per unit cost. Returns BUDGET_EXCEEDED (with minimum cost) rather than faking a conclusion.\n\nPaid: $0.005 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_corporate_cost_optimizer","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"corporate_cost_optimizer","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.005,"actual_cost_usd":0.005},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.005,"charged_price_usd":0.005,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for corporate_cost_optimizer. See example.","example":{"objective":"DECIDE_SUPPLIER_APPROVAL","subject":{"cnpj":"11222333000181"},"constraints":{"max_cost_usd":0.1,"max_latency_ms":4000,"minimum_confidence":85}}}}}}}},"/v1/agent/autonomous-due-diligence/{cnpj}":{"get":{"summary":"Given a business objective and constraints, autonomously plan and run the needed modules within budget/latency/confidenc","description":"Given a business objective and constraints, autonomously plan and run the needed modules within budget/latency/confidence, consolidate evidence, and deliver a decision, reasoning, actions and (optionally) a human report. CNPJ only.\n\nPaid: $0.25 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_autonomous_due_diligence","tags":["data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.envelope.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"example":{"schema_version":"1.0","service_version":"3.0.0","request_id":"req_example","transaction_id":null,"capability":"autonomous_due_diligence","status":"COMPLETED","subject":{"entity_id":null,"entity_type":"BRAZILIAN_COMPANY","cnpj":"11222333000181","legal_name":"ACME LTDA"},"result":{},"decision":{"code":"APPROVE","machine_action":"PROCEED","human_review_required":false,"summary":"","policy_version":""},"confidence":null,"evidence":[],"recommended_actions":[],"execution":{"started_at":"2026-07-10T00:00:00Z","completed_at":"2026-07-10T00:00:01Z","latency_ms":1000,"modules_executed":[],"modules_skipped":[],"sources_consulted":1,"estimated_cost_usd":0.25,"actual_cost_usd":0.25},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.25,"charged_price_usd":0.25,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"},"freshness":{"generated_at":"2026-07-10T00:00:00Z","oldest_source_timestamp":null,"newest_source_timestamp":null,"freshness_score":100,"stale_fields":[]},"cache":{"used":false,"age_seconds":null,"freshness_valid":true},"errors":[]}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input for autonomous_due_diligence. See example.","example":{"objective":"Determine whether this company can be approved as a supplier.","subject":{"cnpj":"11222333000181"},"context":{"use_case":"SUPPLIER_ONBOARDING","transaction_value_usd":50000,"risk_tolerance":"LOW"},"constraints":{"max_cost_usd":0.25,"max_latency_ms":10000,"minimum_confidence":90},"output_preferences":{"include_graph":true,"include_human_report":true}}}}}}}},"/v1/agent/decide":{"post":{"summary":"Brazil Company Decision — Guaranteed Agent Outcome. Give a CNPJ, your objective, budget and required confidence; we prog","description":"Brazil Company Decision — Guaranteed Agent Outcome. Give a CNPJ, your objective, budget and required confidence; we progressively consult the minimum necessary sources, stop at the decision threshold, and return a signed, evidence-backed, machine-executable decision. CNPJ only. Use the free preflight before payment to confirm resolvability and reachable coverage.\n\nPaid: $0.03 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"POST_agent_decide_post","tags":["agent"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.decide.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"description":"Universal decision envelope v1.1: decision + automation_safety + policy + execution_plan + signed decision_receipt (with key_id) + evidence + coverage + limitations + abstention + recovery_options + optional company_decision_passport."},"example":{"schema_version":"1.1","service_version":"3.0.0","capability":"corporate_decision","status":"COMPLETED","subject":{"cnpj":"11222333000181","legal_name":"ACME LTDA"},"decision":{"code":"APPROVE_WITH_MONITORING","machine_action":"PROCEED_WITH_CONTROLS","human_review_required":false},"policy":{"policy_id":"supplier-onboarding-moderate-v1","policy_version":"1.0.0","policy_hash":"…"},"automation_safety":{"safe_to_execute":true,"permitted_actions":["CREATE_VENDOR_RECORD"],"maximum_exposure_usd":10000},"execution_plan":{"plan_id":"plan_…","stopped_because":"TARGET_CONFIDENCE_REACHED","actual_provider_cost_usd":0.012,"cost_avoided_usd":0.006},"decision_receipt":{"receipt_id":"dr_…","signature":"0x…"},"service_guarantee":{"charge_only_if":["minimum_deliverable_produced"],"refund_supported":false},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.03,"charged_price_usd":0.03,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"$id":"cdo.agent.decide.input","type":"object","additionalProperties":false,"required":["subject"],"properties":{"subject":{"type":"object","additionalProperties":false,"required":["cnpj"],"properties":{"type":{"type":"string","maxLength":40,"description":"Entity type; defaults to BRAZILIAN_COMPANY."},"cnpj":{"type":"string","minLength":11,"maxLength":20,"pattern":"^[0-9./\\s-]{11,20}$","description":"Brazilian CNPJ — 14 digits, with or without punctuation (e.g. 11222333000181 or 11.222.333/0001-81). CPF (11-digit personal id) is rejected by policy."}}},"objective":{"type":"string","maxLength":80,"description":"SUPPLIER_ONBOARDING | VENDOR_PAYMENT_APPROVAL | COUNTERPARTY_RISK_ASSESSMENT | MERCHANT_SCREENING (semantic aliases accepted; unknown values fall back to a default policy family).","examples":["SUPPLIER_ONBOARDING","VENDOR_PAYMENT_APPROVAL","COUNTERPARTY_RISK_ASSESSMENT","MERCHANT_SCREENING"]},"question":{"type":"string","maxLength":500,"description":"Optional free-text question for context (does not drive the decision)."},"transaction":{"type":"object","additionalProperties":false,"properties":{"value_usd":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":8},"criticality":{"type":"string","enum":["LOW","MEDIUM","HIGH","CRITICAL"]}}},"constraints":{"type":"object","additionalProperties":false,"properties":{"max_cost_usd":{"type":"number","minimum":0,"description":"USD, must be >= 0."},"minimum_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"maximum_latency_ms":{"type":"number","exclusiveMinimum":0,"maximum":600000,"description":"Milliseconds, must be > 0."}}},"risk_context":{"type":"object","additionalProperties":false,"properties":{"risk_appetite":{"type":"string","enum":["CONSERVATIVE","MODERATE","AGGRESSIVE"]},"jurisdiction":{"type":"string","maxLength":8,"description":"ISO country; only BR is served."}}},"policy":{"type":"object","additionalProperties":false,"properties":{"policy_id":{"type":"string","maxLength":120}},"description":"Reference an existing built-in/custom policy by id."},"custom_policy":{"type":"object","description":"Inline custom policy (validated by the policy validator; returns 422 on invalid)."},"execution_preferences":{"type":"object","additionalProperties":false,"properties":{"progressive":{"type":"boolean"},"include_human_report":{"type":"boolean"},"privacy_mode":{"type":"string","enum":["STANDARD","MINIMAL","HASH_ONLY"]}}}}}}}}}},"/v1/agent/decide/{cnpj}":{"get":{"summary":"Objective-based decision (GET form): /v1/agent/decide/:cnpj?objective=SUPPLIER_ONBOARDING&transaction_value_usd=10000&mi","description":"Objective-based decision (GET form): /v1/agent/decide/:cnpj?objective=SUPPLIER_ONBOARDING&transaction_value_usd=10000&minimum_confidence=90&max_cost_usd=0.25&risk_appetite=MODERATE. Same signed, evidence-backed decision as the POST form; operational validation occurs after x402 acceptance.\n\nPaid: $0.03 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_agent_decide_get","tags":["agent"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.decide.output","type":"object","additionalProperties":true,"required":["schema_version","service_version","request_id","capability","status","subject","result","execution","payment","freshness","cache","errors"],"properties":{"schema_version":{"type":"string","enum":["1.0","1.1"],"description":"1.0 = base capabilities; 1.1 = objective decision (adds decision/policy/automation_safety/receipt/passport)."},"service_version":{"type":"string"},"request_id":{"type":"string","pattern":"^req_"},"transaction_id":{"type":["string","null"]},"capability":{"type":"string"},"status":{"type":"string","enum":["COMPLETED","PARTIALLY_COMPLETED","INSUFFICIENT_DATA","FAILED","PAYMENT_REQUIRED","BUDGET_EXCEEDED","TIMEOUT"]},"subject":{"type":"object","required":["entity_type"],"properties":{"entity_id":{"type":["string","null"]},"entity_type":{"type":"string"},"cnpj":{"type":["string","null"]},"legal_name":{"type":["string","null"]}}},"objective":{"type":["object","null"],"description":"v1.1: objective/question/use_case."},"result":{"type":"object","description":"Capability-specific result payload."},"decision":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"machine_action":{"type":"string","enum":["PROCEED","PROCEED_WITH_CONTROLS","REQUEST_ADDITIONAL_DATA","ESCALATE_TO_HUMAN","BLOCK","RETRY_LATER","SELECT_ALTERNATIVE"]},"human_review_required":{"type":"boolean"},"summary":{"type":"string"},"policy_version":{"type":"string"}}},"automation_safety":{"type":["object","null"],"description":"v1.1: whether an agent may act, and within what exposure.","properties":{"safe_to_execute":{"type":"boolean"},"permitted_actions":{"type":"array","items":{"type":"string"}},"prohibited_actions":{"type":"array","items":{"type":"string"}},"maximum_exposure_usd":{"type":"number","minimum":0},"conditions":{"type":"array","items":{"type":"string"}},"human_review_triggers":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":["object","null"],"properties":{"overall":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_quality":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"data_coverage":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"decision_confidence":{"type":"number","minimum":0,"maximum":100,"description":"0–100."},"evidence_strength":{"type":"number","minimum":0,"maximum":100,"description":"0–100."}}},"reasoning":{"type":["object","null"],"description":"Verifiable justifications only — never model chain-of-thought."},"evidence":{"type":"array","items":{"type":"object"},"description":"Traceable evidence items; absence of evidence is never a negative confirmation."},"recommended_actions":{"type":"array","items":{"type":"object"}},"counterfactuals":{"type":"array","items":{"type":"object"},"description":"Deterministic what-would-change items (when applicable)."},"coverage":{"type":["object","null"]},"limitations":{"type":"array","items":{"type":"string"}},"abstention":{"type":["object","null"],"description":"v1.1: honest abstention with blocking source + retryability."},"execution":{"type":"object","required":["started_at","completed_at","latency_ms"],"properties":{"started_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"modules_executed":{"type":"array","items":{"type":"string"}},"modules_skipped":{"type":"array","items":{"type":"string"}},"sources_consulted":{"type":"integer","minimum":0},"estimated_cost_usd":{"type":"number","minimum":0},"actual_cost_usd":{"type":"number","minimum":0}}},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}},"freshness":{"type":"object","required":["generated_at","freshness_score"],"properties":{"generated_at":{"type":"string","format":"date-time"},"oldest_source_timestamp":{"type":["string","null"]},"newest_source_timestamp":{"type":["string","null"]},"freshness_score":{"type":"number","minimum":0,"maximum":100},"stale_fields":{"type":"array","items":{"type":"string"}}}},"cache":{"type":"object","required":["used"],"properties":{"used":{"type":"boolean"},"age_seconds":{"type":["number","null"],"minimum":0},"freshness_valid":{"type":"boolean"}}},"service_guarantee":{"type":["object","null"]},"decision_receipt":{"type":["object","null"],"description":"v1.1: signed, offline-verifiable receipt (carries key_id + signer)."},"company_decision_passport":{"type":["object","null"],"description":"v1.1: reusable scoped approval; only for approving decisions."},"privacy":{"type":["object","null"]},"recovery_options":{"type":"array","items":{"type":"object"}},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"description":"Universal decision envelope v1.1: decision + automation_safety + policy + execution_plan + signed decision_receipt (with key_id) + evidence + coverage + limitations + abstention + recovery_options + optional company_decision_passport."},"example":{"schema_version":"1.1","service_version":"3.0.0","capability":"corporate_decision","status":"COMPLETED","subject":{"cnpj":"11222333000181","legal_name":"ACME LTDA"},"decision":{"code":"APPROVE_WITH_MONITORING","machine_action":"PROCEED_WITH_CONTROLS","human_review_required":false},"policy":{"policy_id":"supplier-onboarding-moderate-v1","policy_version":"1.0.0","policy_hash":"…"},"automation_safety":{"safe_to_execute":true,"permitted_actions":["CREATE_VENDOR_RECORD"],"maximum_exposure_usd":10000},"execution_plan":{"plan_id":"plan_…","stopped_because":"TARGET_CONFIDENCE_REACHED","actual_provider_cost_usd":0.012,"cost_avoided_usd":0.006},"decision_receipt":{"receipt_id":"dr_…","signature":"0x…"},"service_guarantee":{"charge_only_if":["minimum_deliverable_produced"],"refund_supported":false},"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.03,"charged_price_usd":0.03,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/agent/decision-counterfactual":{"post":{"summary":"Deterministic counterfactual analysis: what would change the decision, the maximum approvable exposure, required documen","description":"Deterministic counterfactual analysis: what would change the decision, the maximum approvable exposure, required documents/evidence, or the impact of removing a risk driver. Derived from the decision engine — never LLM-generated. CNPJ only.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"POST_agent_counterfactual","tags":["agent"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.counterfactual.output","type":"object","additionalProperties":false,"required":["current_decision","type","required_changes","deterministic"],"properties":{"current_decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"target_decision":{"type":["string","null"],"enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE",null]},"type":{"type":"string","enum":["WHAT_WOULD_CHANGE_DECISION","MAXIMUM_APPROVABLE_EXPOSURE","REQUIRED_DOCUMENTS","REQUIRED_EVIDENCE","RISK_DRIVER_REMOVAL","POLICY_CHANGE_IMPACT","SOURCE_AVAILABILITY_IMPACT"]},"required_changes":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["condition","effect","evidence_required"],"properties":{"condition":{"type":"string","description":"Machine-readable change token, e.g. RESOLVE:<code> / PROVIDE_EVIDENCE:<id>."},"effect":{"type":"object","additionalProperties":false,"properties":{"estimated_decision":{"type":"string"},"estimated_confidence":{"type":["number","null"],"minimum":0,"maximum":100}}},"evidence_required":{"type":"array","items":{"type":"string"},"description":"evidence_ids / document ids required to satisfy the change."}}}},"notes":{"type":"array","items":{"type":"string"}},"deterministic":{"const":true,"description":"Always true — derived from the decision engine, never LLM-generated."},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}},"examples":[{"current_decision":"REVIEW","target_decision":"APPROVE","type":"WHAT_WOULD_CHANGE_DECISION","required_changes":[{"condition":"REACH_MINIMUM_COVERAGE","effect":{"estimated_decision":"DECISION_UNBLOCKED","estimated_confidence":85},"evidence_required":["SANCTIONS_SCREENING"]}],"notes":[],"deterministic":true}]},"example":{"current_decision":"REVIEW","target_decision":"APPROVE","type":"WHAT_WOULD_CHANGE_DECISION","required_changes":[{"condition":"REACH_MINIMUM_COVERAGE","effect":{"estimated_decision":"DECISION_UNBLOCKED","estimated_confidence":85},"evidence_required":["SANCTIONS_SCREENING"]}],"notes":[],"deterministic":true,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"$id":"cdo.agent.counterfactual.input","type":"object","additionalProperties":false,"required":["subject","counterfactual"],"properties":{"subject":{"type":"object","additionalProperties":false,"required":["cnpj"],"properties":{"type":{"type":"string","maxLength":40},"cnpj":{"type":"string","minLength":11,"maxLength":20,"pattern":"^[0-9./\\s-]{11,20}$","description":"Brazilian CNPJ — 14 digits, with or without punctuation (e.g. 11222333000181 or 11.222.333/0001-81). CPF (11-digit personal id) is rejected by policy."}}},"objective":{"type":"string","maxLength":80},"risk_context":{"type":"object","additionalProperties":false,"properties":{"risk_appetite":{"type":"string","enum":["CONSERVATIVE","MODERATE","AGGRESSIVE"]}}},"counterfactual":{"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"type":"string","enum":["WHAT_WOULD_CHANGE_DECISION","MAXIMUM_APPROVABLE_EXPOSURE","REQUIRED_DOCUMENTS","REQUIRED_EVIDENCE","RISK_DRIVER_REMOVAL","POLICY_CHANGE_IMPACT","SOURCE_AVAILABILITY_IMPACT"],"description":"Which counterfactual to compute."},"target_decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"],"description":"Optional decision the caller wants to reach."}}}}}}}}}},"/v1/agent/refresh":{"post":{"summary":"Company Intelligence Reassessment — re-runs the FULL decision for a prior subject/passport, reports which domains change","description":"Company Intelligence Reassessment — re-runs the FULL decision for a prior subject/passport, reports which domains changed vs unchanged, and issues a fresh signed receipt (and passport if still approving). Full recomputation at a flat price (not an incremental/delta engine). CNPJ only.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"POST_agent_refresh_post","tags":["agent"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.refresh.output","type":"object","additionalProperties":true,"required":["operation","pricing_mode","recomputation","subject_cnpj","changes_detected","changed_domains","unchanged_domains","new_decision","price_usd","full_recomputation_avoided"],"properties":{"schema_version":{"type":"string","enum":["1.1"]},"operation":{"const":"COMPANY_INTELLIGENCE_REASSESSMENT","description":"Honest label: this is a FULL reassessment, not an incremental/delta refresh."},"pricing_mode":{"const":"FLAT"},"recomputation":{"const":"FULL"},"passport_id":{"type":["string","null"]},"subject_cnpj":{"type":"string"},"changes_detected":{"type":"boolean"},"changed_domains":{"type":"array","items":{"type":"string"}},"unchanged_domains":{"type":"array","items":{"type":"string"}},"previous_decision":{"type":["string","null"],"enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE",null]},"new_decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"price_usd":{"type":"number","minimum":0},"new_passport_id":{"type":["string","null"]},"new_receipt_id":{"type":"string"},"delta_price_usd":{"type":"number","minimum":0,"deprecated":true,"description":"@deprecated alias of price_usd — kept for older clients; pricing is flat, never a delta."},"full_recomputation_avoided":{"const":false,"description":"Always false — the whole decision is recomputed every call."},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}},"examples":[{"operation":"COMPANY_INTELLIGENCE_REASSESSMENT","pricing_mode":"FLAT","recomputation":"FULL","subject_cnpj":"11222333000181","changes_detected":true,"changed_domains":["decision"],"unchanged_domains":["evidence"],"previous_decision":"APPROVE","new_decision":"APPROVE_WITH_MONITORING","price_usd":0.01,"new_passport_id":null,"new_receipt_id":"dr_x","delta_price_usd":0.01,"full_recomputation_avoided":false}]},"example":{"operation":"COMPANY_INTELLIGENCE_REASSESSMENT","pricing_mode":"FLAT","recomputation":"FULL","subject_cnpj":"11222333000181","changes_detected":true,"changed_domains":["decision"],"unchanged_domains":["evidence"],"previous_decision":"APPROVE","new_decision":"APPROVE_WITH_MONITORING","price_usd":0.01,"new_passport_id":null,"new_receipt_id":"dr_x","delta_price_usd":0.01,"full_recomputation_avoided":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}},"requestBody":{"content":{"application/json":{"schema":{"$id":"cdo.agent.refresh.input","type":"object","additionalProperties":false,"properties":{"passport_id":{"type":"string","maxLength":60},"subject":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","maxLength":40},"cnpj":{"type":"string","minLength":11,"maxLength":20,"pattern":"^[0-9./\\s-]{11,20}$","description":"Brazilian CNPJ — 14 digits, with or without punctuation (e.g. 11222333000181 or 11.222.333/0001-81). CPF (11-digit personal id) is rejected by policy."}}},"objective":{"type":"string","maxLength":80},"risk_context":{"type":"object","additionalProperties":false,"properties":{"risk_appetite":{"type":"string","enum":["CONSERVATIVE","MODERATE","AGGRESSIVE"]}}}},"anyOf":[{"required":["passport_id"]},{"required":["subject"]}]}}}}}},"/v1/agent/refresh/{passport_id}":{"get":{"summary":"Company Intelligence Reassessment by passport id (GET form). Full recomputation at a flat price.","description":"Company Intelligence Reassessment by passport id (GET form). Full recomputation at a flat price.\n\nPaid: $0.01 USDC via x402 (Base). Unpaid requests return HTTP 402.","operationId":"GET_agent_refresh_get","tags":["agent"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$id":"cdo.agent.refresh.output","type":"object","additionalProperties":true,"required":["operation","pricing_mode","recomputation","subject_cnpj","changes_detected","changed_domains","unchanged_domains","new_decision","price_usd","full_recomputation_avoided"],"properties":{"schema_version":{"type":"string","enum":["1.1"]},"operation":{"const":"COMPANY_INTELLIGENCE_REASSESSMENT","description":"Honest label: this is a FULL reassessment, not an incremental/delta refresh."},"pricing_mode":{"const":"FLAT"},"recomputation":{"const":"FULL"},"passport_id":{"type":["string","null"]},"subject_cnpj":{"type":"string"},"changes_detected":{"type":"boolean"},"changed_domains":{"type":"array","items":{"type":"string"}},"unchanged_domains":{"type":"array","items":{"type":"string"}},"previous_decision":{"type":["string","null"],"enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE",null]},"new_decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","APPROVE_WITH_MONITORING","REVIEW","REJECT","UNABLE_TO_DECIDE"]},"price_usd":{"type":"number","minimum":0},"new_passport_id":{"type":["string","null"]},"new_receipt_id":{"type":"string"},"delta_price_usd":{"type":"number","minimum":0,"deprecated":true,"description":"@deprecated alias of price_usd — kept for older clients; pricing is flat, never a delta."},"full_recomputation_avoided":{"const":false,"description":"Always false — the whole decision is recomputed every call."},"payment":{"type":"object","required":["payment_status","protocol"],"properties":{"status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"payment_status":{"type":"string","enum":["SETTLED","PENDING","NOT_REQUIRED","REFUSED"]},"quoted_price_usd":{"type":["number","null"],"minimum":0},"charged_price_usd":{"type":["number","null"],"minimum":0},"payment_reference":{"type":["string","null"]},"transaction_hash":{"type":["string","null"]},"network":{"type":["string","null"]},"asset":{"type":["string","null"]},"payee":{"type":["string","null"]},"persistence_status":{"type":"string","enum":["PERSISTED","RECONCILIATION_REQUIRED"]},"protocol":{"type":"string","enum":["x402"]}}}},"examples":[{"operation":"COMPANY_INTELLIGENCE_REASSESSMENT","pricing_mode":"FLAT","recomputation":"FULL","subject_cnpj":"11222333000181","changes_detected":true,"changed_domains":["decision"],"unchanged_domains":["evidence"],"previous_decision":"APPROVE","new_decision":"APPROVE_WITH_MONITORING","price_usd":0.01,"new_passport_id":null,"new_receipt_id":"dr_x","delta_price_usd":0.01,"full_recomputation_avoided":false}]},"example":{"operation":"COMPANY_INTELLIGENCE_REASSESSMENT","pricing_mode":"FLAT","recomputation":"FULL","subject_cnpj":"11222333000181","changes_detected":false,"changed_domains":[],"unchanged_domains":["evidence","decision"],"previous_decision":"APPROVE","new_decision":"APPROVE","price_usd":0.01,"new_passport_id":null,"new_receipt_id":"dr_x","delta_price_usd":0.01,"full_recomputation_avoided":false,"payment":{"status":"SETTLED","payment_status":"SETTLED","quoted_price_usd":0.01,"charged_price_usd":0.01,"payment_reference":"0xtransaction_hash","transaction_hash":"0xtransaction_hash","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payee":"0x0D0E3539Da45c573AF8730045e7D5F634243f3d3","persistence_status":"PERSISTED","protocol":"x402"}}}}},"400":{"description":"Invalid input (e.g. CPF or malformed CNPJ) — not charged."},"402":{"description":"Payment required (x402). Retry with PAYMENT-SIGNATURE header."},"503":{"description":"Required source stale/unavailable — not charged."}}}},"/v1/agent/preflight/{cnpj}":{"get":{"summary":"Free preflight estimate","operationId":"preflight","responses":{"200":{"description":"OK"}}}},"/v1/agent/service-proof":{"get":{"summary":"Signed service proof","operationId":"serviceProof","responses":{"200":{"description":"OK"}}}},"/v1/agent/capabilities":{"get":{"summary":"Free capability catalog","operationId":"capabilities","responses":{"200":{"description":"OK"}}}},"/v1/us/federal/source-health":{"get":{"summary":"Current metadata-only health for the four required US federal restricted-party sources","operationId":"getUsFederalSourceHealth","tags":["United States"],"responses":{"200":{"description":"Current persisted source health without raw SAM payloads or normalized records"}},"x-economic":false,"x-coverage":"FEDERAL_ONLY"}},"/v1/us/company-check":{"post":{"operationId":"company_check","summary":"Company Check","description":"Bind the intended US company to a public identifier and evaluate its situation against the applicable federal gate using persisted certified source snapshots. Coverage is FEDERAL_ONLY: the result does not assert national legal existence or good standing, and absence from SAM, SEC or USAspending is not nonexistence. The product returns evidence, ambiguity, source health, freshness and limitations with one composite x402 charge.","tags":["company-check"],"x-product-id":"us.company.check.v1","x-solution":"COMPANY_CHECK","x-policy":{"id":"US_COMPANY_CHECK_V1","version":"1.0.0"},"x-price":{"amount":"0.04","amount_atomic":"40000","asset":"USDC","network":"eip155:8453","version":"1.0.0"},"x-x402":{"version":2,"network":"eip155:8453","asset":"USDC","paymentHeader":"PAYMENT-SIGNATURE","oneChallenge":true,"oneSettlement":true},"x-idempotency":{"bodyField":"idempotency_key","required":true,"durable":true},"x-retries":{"reuseIdempotencyKey":true,"identicalMaterialRequired":true,"replayStoredDelivery":true},"x-no-charge":["HTTP_400","HTTP_404_TECHNICAL","HTTP_409","HTTP_422","HTTP_424","HTTP_429","HTTP_503","INPUT_INSUFFICIENT","PUBLIC_IDENTIFIER_REQUIRED","ENTITY_AMBIGUOUS","ENTITY_UNRESOLVED","COVERAGE_UNAVAILABLE","SOURCE_UNAVAILABLE","SOURCE_STALE","SCHEMA_BREAK","POLICY_UNAVAILABLE","EVIDENCE_INCOMPLETE","REPLAY_INVALID","TIMEOUT_BEFORE_DECISION","QUOTE_DRIFT","EXECUTION_CANCELLED","CDORACLE_RETRY_LATER"],"x-freshness":{"ttlSeconds":21600,"staleFailsClosed":true},"x-coverage":{"scope":"FEDERAL_ONLY","supportedJurisdictions":["US","US-STATE-IDENTIFIER"],"publicIdentifierRequired":true,"nationalPrivateNameResolution":false,"nationalLegalExistenceClaim":false,"nationalGoodStandingClaim":false,"stateLegalStatus":"ONLY_WHEN_SEPARATELY_CERTIFIED"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company","policy_id","idempotency_key"],"properties":{"company":{"type":"object","additionalProperties":false,"required":["identifier","legal_name","jurisdiction"],"properties":{"identifier":{"type":"object","additionalProperties":false,"required":["scheme","value","evidence_reference"],"properties":{"scheme":{"type":"string","enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI"]},"value":{"type":"string","minLength":1,"maxLength":160},"evidence_reference":{"type":"string","pattern":"^(?:https://[^?\\s#]+|canonical-entity:[A-Za-z0-9_-]+)$"}}},"legal_name":{"type":"string","minLength":1,"maxLength":500},"jurisdiction":{"type":"string","pattern":"^US(?:-[A-Z]{2})?$"},"entity_id":{"type":"string","pattern":"^ent_[A-Za-z0-9_-]+$"}}},"policy_id":{"const":"US_COMPANY_CHECK_V1"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}},"examples":{"identifier":{"value":{"company":{"legal_name":"Example Federal Supplier LLC","jurisdiction":"US-CO","identifier":{"scheme":"STATE_ENTITY_NUMBER","value":"20241234567","evidence_reference":"https://example.gov/entities/20241234567"}},"policy_id":"US_COMPANY_CHECK_V1","idempotency_key":"company-check-001"}},"uei":{"value":{"company":{"legal_name":"Example Federal Supplier LLC","jurisdiction":"US","identifier":{"scheme":"UEI","value":"EXAMPLE123456","evidence_reference":"https://sam.gov/entity/example"}},"policy_id":"US_COMPANY_CHECK_V1","idempotency_key":"company-check-002"}}}}}},"responses":{"200":{"description":"Delivered Company Check decision; settlement is represented in billing.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","solution","solution_version","request_id","execution_id","quote_id","request_digest","policy","decision","authorization","machine_action","confidence","risk_level","reason_codes","conditions","required_information","company","ambiguity","checks_executed","checks_reused","coverage","source_health","evidence_ids","freshness","limitations","valid_as_of","valid_until","authorization_token","charged","billing","delivery"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"solution":{"const":"COMPANY_CHECK"},"solution_version":{"const":"1.0.0"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"execution_id":{"type":"string","minLength":1},"quote_id":{"type":"string","minLength":1},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"const":"US_COMPANY_CHECK_V1"},"version":{"const":"1.0.0"}}},"decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","REJECT","INSUFFICIENT_EVIDENCE"]},"authorization":{"type":"string","enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","RETRY_LATER"]},"machine_action":{"type":"string","enum":["USE_COMPANY","PRESENT_CANDIDATES","REQUEST_IDENTIFIER","REQUEST_IDENTITY_EVIDENCE","HOLD","BLOCK","RETRY_LATER"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"risk_level":{"anyOf":[{"type":"string","enum":["LOW","MEDIUM","HIGH","CRITICAL"]},{"type":"null"}]},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","required_before_action"],"properties":{"code":{"type":"string"},"required_before_action":{"type":"boolean"}}}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"company":{"type":"object","additionalProperties":false,"required":["entity_id","legal_name","jurisdiction","identifier","resolution_status","legal_status"],"properties":{"entity_id":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"identifier":{"type":"object","additionalProperties":false,"required":["scheme","value","evidence_reference"],"properties":{"scheme":{"type":"string"},"value":{"type":"string"},"evidence_reference":{"type":"string"}}},"resolution_status":{"type":"string","enum":["MATCH","AMBIGUOUS"]},"legal_status":{"const":"UNKNOWN"}}},"ambiguity":{"type":"object","additionalProperties":false,"required":["status","candidate_count","candidates"],"properties":{"status":{"type":"string","enum":["UNAMBIGUOUS","AMBIGUOUS"]},"candidate_count":{"type":"integer","minimum":0},"candidates":{"type":"array","items":{"type":"string"}}}},"checks_executed":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["check_id","capability","scope"],"properties":{"check_id":{"type":"string"},"capability":{"type":"string"},"scope":{"type":"string"}}}},"checks_reused":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["check_id","capability","scope"],"properties":{"check_id":{"type":"string"},"capability":{"type":"string"},"scope":{"type":"string"}}}},"coverage":{"type":"object","additionalProperties":false,"required":["scope","supported","state_legal_status","limitations"],"properties":{"scope":{"const":"FEDERAL_ONLY"},"supported":{"type":"boolean"},"state_legal_status":{"const":"NOT_ASSERTED"},"limitations":{"type":"array","items":{"type":"string"}}}},"source_health":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source_id","status","artifact_digest","valid_as_of","valid_until"],"properties":{"source_id":{"type":"string"},"status":{"type":"string"},"artifact_digest":{"anyOf":[{"type":"string"},{"type":"null"}]},"valid_as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"evidence_ids":{"type":"array","items":{"type":"string"}},"freshness":{"type":"object","additionalProperties":false,"required":["status","valid_as_of","valid_until"],"properties":{"status":{"const":"CURRENT"},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"}}},"limitations":{"type":"array","items":{"type":"string"}},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"authorization_token":{"type":"null"},"charged":{"type":"boolean"},"billing":{"type":"object","additionalProperties":false,"required":["mode","primitive_billing","charge_reference"],"properties":{"mode":{"const":"COMPOSITE_SINGLE_CHARGE"},"primitive_billing":{"const":"DISABLED"},"charge_reference":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"delivery":{"type":"object","additionalProperties":false,"required":["status","result_digest"],"properties":{"status":{"const":"DELIVERED"},"result_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}}}}}}},"400":{"description":"Invalid strict input; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"401":{"description":"Internal mode authentication required; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"402":{"description":"x402 payment challenge for the single composite quote."},"404":{"description":"Technical route or resolution dependency not found; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"409":{"description":"Ambiguity, idempotency conflict, replay conflict, or quote drift; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"422":{"description":"Unsupported coverage or invalid policy; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"424":{"description":"Mandatory capability, evidence, or source contract unavailable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"429":{"description":"Rate limit; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"503":{"description":"Source unavailable/stale, timeout, disabled mode, or retry later; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"/v1/us/suppliers/approve":{"post":{"operationId":"approve_us_supplier","summary":"Approve US Supplier","description":"Approve, condition, hold or reject a US supplier under the federal-only US_FEDERAL_COUNTERPARTY_V1 policy. Identity, four named official-source snapshots, freshness, completeness and replay are validated before any x402 payment operation.","tags":["supplier-approval"],"x-product-id":"us.supplier.approve.v1","x-solution":"SUPPLIER_APPROVAL","x-policy":{"id":"US_FEDERAL_COUNTERPARTY_V1","version":"1.0.0"},"x-price":{"amount":"0.20","amount_atomic":"200000","asset":"USDC","network":"eip155:8453"},"x-x402":{"version":2,"network":"eip155:8453","asset":"USDC","paymentHeader":"PAYMENT-SIGNATURE","oneChallenge":true,"oneVerification":true,"oneSettlement":true,"oneDelivery":true},"x-idempotency":{"header":"Idempotency-Key","required":true,"durable":true,"identicalPayloadRequired":true},"x-no-charge":["INVALID_OR_UNSUPPORTED_INPUT","AMBIGUOUS_IDENTITY","SOURCE_UNAVAILABLE","SOURCE_STALE","SCHEMA_BREAK","PARTIAL_DATASET","HOLD","REJECT","INSUFFICIENT_EVIDENCE","RETRY_LATER"],"x-replay":{"historicalSources":"PRESERVED_ONLY","externalSourcesQueried":false,"expectedResult":"MATCH","deliveryRequiresMatch":true,"components":["NORMALIZED_INPUT","PRODUCT_VERSION","POLICY_VERSION","RULE_VERSIONS","SOURCE_VERSIONS","EVIDENCE_HASHES","ENGINE_VERSION","DECISION_OUTPUT","AUTHORIZATION","TOKEN_FINGERPRINT"]},"x-authorization-token":{"responseField":"authorization_token","semanticName":"supplier_approval_token","format":"CDO-AUTHORIZATION-TOKEN-V1","algorithm":"EdDSA","issuedFor":"APPROVE_WHEN_SIGNER_CERTIFIED","boundTo":["SUPPLIER","PRODUCT_VERSION","DECISION_BUNDLE","POLICY","EVIDENCE_DIGEST","AUDIENCE","TENANT_SCOPE","CALLER_SCOPE"],"verification":{"keySelection":"key_id","audience":true,"subject":true,"product":true,"policy":true,"evidenceDigest":true,"notBefore":true,"expiry":true,"revocation":true,"usageLimit":true},"rotation":{"activeSigningKey":true,"retiredVerifyOnlyKeys":true,"revokedKeysRejected":true},"limitations":["The token does not prove ownership of a bank account or wallet.","The token is limited to the named supplier, policy, actions, conditions, limits and audience."]},"x-remediation":{"holdIsContractedDecision":true,"holdIsChargeable":true,"approvalTokenIssued":false,"resumeReference":"remediation.remediation_id","checksReusedWhileCurrent":true},"x-freshness":{"maximumTtlSeconds":21600,"staleFailsClosed":true},"x-coverage":{"country":"US","scope":"FEDERAL_ONLY","explicitJurisdictionsOnly":false,"namedSources":["US_OFAC_SLS_SDN","US_OFAC_SLS_NON_SDN","US_ITA_CSL","US_SAM_EXCLUSIONS"],"limitations":["FEDERAL_ONLY coverage does not establish national or state legal existence or good standing.","Absence in SAM, SEC, USAspending or FAC is not evidence of business nonexistence.","Nominal OFAC screening does not assess the OFAC 50 Percent Rule.","Supplier Approval does not authorize an invoice, payee, bank account, wallet, contracting award or payment."]},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"supplier":{"type":"object","additionalProperties":false,"properties":{"caller_supplier_reference":{"type":"string","minLength":1,"maxLength":120},"entity_id":{"type":"string","minLength":1,"maxLength":120},"identifier":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI","EIN"]},"value":{"type":"string","minLength":1,"maxLength":80},"fingerprint":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"reference":{"type":"string","minLength":1,"maxLength":120},"jurisdiction":{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"}},"required":["type"]},"legal_name":{"type":"string","minLength":1,"maxLength":200},"jurisdiction":{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"},"product_or_service":{"type":"string","minLength":1,"maxLength":300},"sector":{"type":"string","minLength":1,"maxLength":100},"relationship":{"const":"NEW_SUPPLIER"},"spend_band":{"type":"string","enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]}},"required":["caller_supplier_reference","legal_name","jurisdiction","relationship","spend_band"]},"payee":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider":{"type":"string","minLength":1,"maxLength":80},"merchant_url":{"type":"string","minLength":1,"maxLength":500,"format":"uri","pattern":"^https://"},"fingerprint":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}},"required":["type","value"]},"documents":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"document_id":{"type":"string","minLength":1,"maxLength":120},"document_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"type":{"type":"string","minLength":1,"maxLength":80}},"required":["document_id","document_digest","type"]},"maxItems":30},"policy":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","enum":["US_LEGAL_EXISTENCE_V1","US_COMPANY_CHECK_V1","US_INVOICE_MATCH_V1","US_PAYEE_BINDING_V1","US_INVOICE_PAYEE_VERIFICATION_V1","US_NEW_SUPPLIER_V1","US_FEDERAL_COUNTERPARTY_V1","US_VENDOR_PAYMENT_DETAIL_CHANGE_V1","US_LOW_VALUE_PAYMENT_V1","US_EXISTING_SUPPLIER_PAYMENT_V1","US_HIGH_VALUE_PAYMENT_V1","US_NEW_SUPPLIER_PAYMENT_V1","US_PAYMENT_AUTHORIZATION_V1"]},"version":{"const":"1.0.0"}},"required":["id","version"]}},"required":["supplier"]},"example":{"supplier":{"caller_supplier_reference":"supplier_demo_001","entity_id":"ent_demo_001","legal_name":"Example Components LLC","jurisdiction":"US-DE","product_or_service":"Industrial components","sector":"Manufacturing","relationship":"NEW_SUPPLIER","spend_band":"MEDIUM"},"payee":{"type":"PROVIDER_ACCOUNT_TOKEN","value":"tok_demo_payee","provider":"example_provider","provider_namespace":"example"},"documents":[{"document_id":"doc_demo_001","document_digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000","type":"W9_REFERENCE"}]}}}},"responses":{"200":{"description":"One delivered Supplier Approval decision. Authorization and remediation fields reflect the frozen policy outcome.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","minLength":1,"maxLength":120,"pattern":"^req_[A-Za-z0-9_-]+$"},"request_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"idempotency_reference":{"type":"string","minLength":1,"maxLength":120,"pattern":"^idem_[A-Za-z0-9_-]+$"},"policy":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","enum":["US_LEGAL_EXISTENCE_V1","US_COMPANY_CHECK_V1","US_INVOICE_MATCH_V1","US_PAYEE_BINDING_V1","US_INVOICE_PAYEE_VERIFICATION_V1","US_NEW_SUPPLIER_V1","US_FEDERAL_COUNTERPARTY_V1","US_VENDOR_PAYMENT_DETAIL_CHANGE_V1","US_LOW_VALUE_PAYMENT_V1","US_EXISTING_SUPPLIER_PAYMENT_V1","US_HIGH_VALUE_PAYMENT_V1","US_NEW_SUPPLIER_PAYMENT_V1","US_PAYMENT_AUTHORIZATION_V1"]},"version":{"const":"1.0.0"}},"required":["id","version"]},"decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","HOLD","REVIEW","REJECT","INSUFFICIENT_EVIDENCE"]},"authorization":{"type":"string","enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","RETRY_LATER"]},"machine_action":{"type":"string","enum":["USE_ENTITY","PRESENT_CANDIDATES","REQUEST_JURISDICTION","REQUEST_IDENTIFIER","STOP","CONTINUE_ONBOARDING","REQUEST_CERTIFICATE","CONTINUE_TO_PAYMENT_PREFLIGHT","REQUEST_CORRECTED_INVOICE","HOLD_INVOICE","BLOCK_INVOICE","USE_PAYEE","REQUEST_PAYEE_PROOF","REQUEST_INDEPENDENT_CONFIRMATION","ENABLE_VENDOR","ENABLE_WITH_LIMITS","REQUEST_INFORMATION","REQUEST_DOCUMENT","HOLD_ONBOARDING","REJECT_VENDOR","UPDATE_VENDOR_PAYEE","HOLD_VENDOR_CHANGE","BLOCK_VENDOR_CHANGE","RELEASE_PAYMENT","HOLD_PAYMENT","BLOCK_PAYMENT","RETRY_LATER"]},"confidence":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"confidence_components":{"type":"object","additionalProperties":false,"properties":{"identity":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true},"evidence":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"freshness":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"policy_completeness":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"extraction":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true},"payee_binding":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true},"invoice_match":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true}},"required":["identity","evidence","freshness","policy_completeness"]},"risk_level":{"type":"string","enum":["LOW","MEDIUM","HIGH","CRITICAL","UNKNOWN"]},"risk_scope":{"type":"string","enum":["SUPPORTED_POLICY_SCOPE","IDENTITY_ONLY","REGISTRATION_ONLY","INVOICE_MATCH_ONLY","PAYEE_BINDING_ONLY","PARTIAL_COVERAGE","NOT_ASSESSED"]},"reason_codes":{"type":"array","items":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_JURISDICTION","COVERAGE_UNAVAILABLE","ENTITY_AMBIGUOUS","ENTITY_NOT_FOUND","ENTITY_CONFLICT","SOURCE_UNAVAILABLE","SOURCE_STALE","SOURCE_SCHEMA_INCOMPATIBLE","SOURCE_AUTHENTICATION_FAILED","PARTIAL_COVERAGE","POLICY_INPUT_MISSING","MANDATORY_CHECK_INCOMPLETE","IDEMPOTENCY_CONFLICT","QUOTE_EXPIRED","QUOTE_INVALIDATED","HEALTH_DIGEST_CHANGED","AUTHORIZATION_EXPIRED","AUTHORIZATION_REVOKED","AUTHORIZATION_SCOPE_MISMATCH","AUTHORIZATION_ALREADY_CONSUMED","REMEDIATION_REQUIRED","JURISDICTION_REQUIRED","IDENTIFIER_REQUIRED","LEGAL_STATUS_NOT_ACTIVE","REGISTRATION_NOT_FOUND","INVOICE_ENTITY_MISMATCH","INVOICE_TOTAL_REQUIRED","INVOICE_DATE_INVALID","PAYEE_UNRESOLVED","PAYEE_MISMATCH","PAYEE_PROOF_REQUIRED","INDEPENDENT_CONFIRMATION_REQUIRED","SUPPLIER_INFORMATION_MISSING","SUPPLIER_REJECTED","VENDOR_CHANGE_UNCONFIRMED","PAYMENT_OBLIGATION_MISMATCH"]},"maxItems":50},"conditions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","minLength":1,"maxLength":80},"description":{"type":"string","minLength":1,"maxLength":500},"required_before_action":{"type":"boolean"},"expires_at":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"evidence_requirements":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":20}},"required":["code","required_before_action","evidence_requirements"]},"maxItems":30},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","minLength":1,"maxLength":80},"reason_code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_JURISDICTION","COVERAGE_UNAVAILABLE","ENTITY_AMBIGUOUS","ENTITY_NOT_FOUND","ENTITY_CONFLICT","SOURCE_UNAVAILABLE","SOURCE_STALE","SOURCE_SCHEMA_INCOMPATIBLE","SOURCE_AUTHENTICATION_FAILED","PARTIAL_COVERAGE","POLICY_INPUT_MISSING","MANDATORY_CHECK_INCOMPLETE","IDEMPOTENCY_CONFLICT","QUOTE_EXPIRED","QUOTE_INVALIDATED","HEALTH_DIGEST_CHANGED","AUTHORIZATION_EXPIRED","AUTHORIZATION_REVOKED","AUTHORIZATION_SCOPE_MISMATCH","AUTHORIZATION_ALREADY_CONSUMED","REMEDIATION_REQUIRED","JURISDICTION_REQUIRED","IDENTIFIER_REQUIRED","LEGAL_STATUS_NOT_ACTIVE","REGISTRATION_NOT_FOUND","INVOICE_ENTITY_MISMATCH","INVOICE_TOTAL_REQUIRED","INVOICE_DATE_INVALID","PAYEE_UNRESOLVED","PAYEE_MISMATCH","PAYEE_PROOF_REQUIRED","INDEPENDENT_CONFIRMATION_REQUIRED","SUPPLIER_INFORMATION_MISSING","SUPPLIER_REJECTED","VENDOR_CHANGE_UNCONFIRMED","PAYMENT_OBLIGATION_MISMATCH"]},"field_path":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":500},"accepted_evidence_types":{"type":"array","items":{"type":"string","enum":["OFFICIAL_RECORD","CALLER_PROVIDED_DOCUMENT","MERCHANT_ASSERTION","SUPPLIER_ASSERTION","INDEPENDENT_CONFIRMATION","PROVIDER_ATTESTATION","SIGNED_WALLET_CHALLENGE"]},"maxItems":20}},"required":["type","reason_code","field_path","accepted_evidence_types"]},"maxItems":30},"checks_executed":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"check_id":{"type":"string","minLength":1,"maxLength":120},"check_version":{"type":"string","minLength":1,"maxLength":40},"status":{"type":"string","minLength":1,"maxLength":80},"source_version_set_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"result_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"valid_until":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"reused":{"type":"boolean"}},"required":["check_id","check_version","status","source_version_set_digest","result_digest","valid_until","reused"]},"maxItems":100},"checks_reused":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"check_id":{"type":"string","minLength":1,"maxLength":120},"check_version":{"type":"string","minLength":1,"maxLength":40},"status":{"type":"string","minLength":1,"maxLength":80},"source_version_set_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"result_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"valid_until":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"reused":{"type":"boolean"}},"required":["check_id","check_version","status","source_version_set_digest","result_digest","valid_until","reused"]},"maxItems":100},"coverage":{"type":"object","additionalProperties":false,"properties":{"supported":{"type":"boolean"},"country":{"const":"US"},"jurisdictions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"},"maxItems":56},"populations":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":50},"included_sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":120},"maxItems":50},"excluded_sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":120},"maxItems":50},"limitations":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"maxItems":50},"manifest_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"}},"required":["supported","country","jurisdictions","populations","included_sources","excluded_sources","limitations","manifest_digest"]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"source_id":{"type":"string","minLength":1,"maxLength":120},"status":{"type":"string","enum":["HEALTHY","DEGRADED","STALE","UNAVAILABLE","SCHEMA_BREAK","UNKNOWN"]},"source_version":{"type":"string","minLength":1,"maxLength":80},"health_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"source_updated_at":{"anyOf":[{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},{"type":"null"}]},"collected_at":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"valid_as_of":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"expires_at":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"}},"required":["source_id","status","source_version","health_digest","source_updated_at","collected_at","valid_as_of","expires_at"]},"maxItems":100},"evidence_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":120},"maxItems":100},"valid_as_of":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"valid_until":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"authorization_token":{"anyOf":[{"type":"string","minLength":1,"maxLength":8192},{"type":"null"}]},"remediation":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"remediation_id":{"type":"string","minLength":1,"maxLength":120},"status":{"type":"string","enum":["REQUIRED","IN_PROGRESS","COMPLETED"]}},"required":["remediation_id","status"]},{"type":"null"}]},"commerce":{"type":"object","additionalProperties":false,"properties":{"quote_id":{"type":"string","minLength":1,"maxLength":120},"amount":{"type":"string","minLength":1,"maxLength":30,"pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"asset":{"const":"USDC"},"network":{"const":"eip155:8453"},"charge_reference":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"settlement_reference":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]}},"required":["quote_id","amount","asset","network","charge_reference","settlement_reference"]},"subject":{"type":"object","additionalProperties":false,"properties":{"entity_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"country":{"const":"US"},"jurisdiction":{"anyOf":[{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"},{"type":"null"}]}},"required":["entity_id","country","jurisdiction"]},"result":{"type":"object","additionalProperties":false,"properties":{"supplier_id":{"type":"string","minLength":1,"maxLength":120},"supplier_authorization_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"approval_limits":{"type":"object","additionalProperties":false,"properties":{"spend_band":{"type":"string","enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]},"valid_until":{"anyOf":[{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},{"type":"null"}]},"conditions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":30}},"required":["spend_band","valid_until","conditions"]},"supplier_status":{"type":"string","enum":["APPROVED","APPROVED_WITH_CONDITIONS","ON_HOLD","REJECTED"]}},"required":["supplier_id","supplier_authorization_id","approval_limits","supplier_status"]}},"required":["schema_version","product","request_id","request_digest","idempotency_reference","policy","decision","authorization","machine_action","confidence","confidence_components","risk_level","risk_scope","reason_codes","conditions","required_information","checks_executed","checks_reused","coverage","source_health","evidence_ids","valid_as_of","valid_until","authorization_token","remediation","commerce","subject","result"]},"examples":{"approve":{"value":{"schema_version":"1.0.0","product":"us.supplier.approve.v1","request_id":"req_demo_001","request_digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000","idempotency_reference":"idem_demo_001","policy":{"id":"US_NEW_SUPPLIER_V1","version":"1.0.0"},"decision":"APPROVE","authorization":"ALLOW","machine_action":"CONTINUE_ONBOARDING","confidence":0.95,"confidence_components":{"identity":0.95,"evidence":0.9,"freshness":0.9,"policy_completeness":0.9,"extraction":null,"payee_binding":null,"invoice_match":null},"risk_level":"LOW","risk_scope":"SUPPORTED_POLICY_SCOPE","reason_codes":[],"conditions":[],"required_information":[],"checks_executed":[],"checks_reused":[],"coverage":{"supported":true,"country":"US","jurisdictions":["US-DE"],"populations":["DOMESTIC_ENTITY"],"included_sources":[],"excluded_sources":[],"limitations":[],"manifest_digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"source_health":[],"evidence_ids":[],"valid_as_of":"2026-07-19T12:00:00Z","valid_until":"2026-07-20T12:00:00Z","authorization_token":null,"remediation":null,"commerce":{"quote_id":"quote_demo_001","amount":"0.20","asset":"USDC","network":"eip155:8453","charge_reference":null,"settlement_reference":null},"subject":{"entity_id":"ent_demo_001","country":"US","jurisdiction":"US-DE"},"result":{"supplier_id":"supplier_demo_001","supplier_authorization_id":"auth_demo_001","approval_limits":{"spend_band":"MEDIUM","valid_until":"2026-07-20T12:00:00Z","conditions":[]},"supplier_status":"APPROVED"}}},"hold":{"value":{"schema_version":"1.0.0","product":"us.supplier.approve.v1","request_id":"req_demo_001","request_digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000","idempotency_reference":"idem_demo_001","policy":{"id":"US_NEW_SUPPLIER_V1","version":"1.0.0"},"decision":"REVIEW","authorization":"HOLD","machine_action":"REQUEST_INFORMATION","confidence":0.5,"confidence_components":{"identity":0.95,"evidence":0.9,"freshness":0.9,"policy_completeness":0.9,"extraction":null,"payee_binding":null,"invoice_match":null},"risk_level":"UNKNOWN","risk_scope":"NOT_ASSESSED","reason_codes":["MANDATORY_CHECK_INCOMPLETE"],"conditions":[],"required_information":[],"checks_executed":[],"checks_reused":[],"coverage":{"supported":true,"country":"US","jurisdictions":["US-DE"],"populations":["DOMESTIC_ENTITY"],"included_sources":[],"excluded_sources":[],"limitations":[],"manifest_digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"source_health":[],"evidence_ids":[],"valid_as_of":"2026-07-19T12:00:00Z","valid_until":"2026-07-20T12:00:00Z","authorization_token":null,"remediation":null,"commerce":{"quote_id":"quote_demo_001","amount":"0.20","asset":"USDC","network":"eip155:8453","charge_reference":null,"settlement_reference":null},"subject":{"entity_id":"ent_demo_001","country":"US","jurisdiction":"US-DE"},"result":{"supplier_id":"supplier_demo_001","supplier_authorization_id":"auth_demo_001","approval_limits":{"spend_band":"MEDIUM","valid_until":"2026-07-20T12:00:00Z","conditions":[]},"supplier_status":"APPROVED"}}},"reject":{"value":{"schema_version":"1.0.0","product":"us.supplier.approve.v1","request_id":"req_demo_001","request_digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000","idempotency_reference":"idem_demo_001","policy":{"id":"US_NEW_SUPPLIER_V1","version":"1.0.0"},"decision":"REJECT","authorization":"BLOCK","machine_action":"STOP","confidence":0.5,"confidence_components":{"identity":0.95,"evidence":0.9,"freshness":0.9,"policy_completeness":0.9,"extraction":null,"payee_binding":null,"invoice_match":null},"risk_level":"UNKNOWN","risk_scope":"NOT_ASSESSED","reason_codes":["ENTITY_CONFLICT"],"conditions":[],"required_information":[],"checks_executed":[],"checks_reused":[],"coverage":{"supported":true,"country":"US","jurisdictions":["US-DE"],"populations":["DOMESTIC_ENTITY"],"included_sources":[],"excluded_sources":[],"limitations":[],"manifest_digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"source_health":[],"evidence_ids":[],"valid_as_of":"2026-07-19T12:00:00Z","valid_until":"2026-07-20T12:00:00Z","authorization_token":null,"remediation":null,"commerce":{"quote_id":"quote_demo_001","amount":"0.20","asset":"USDC","network":"eip155:8453","charge_reference":null,"settlement_reference":null},"subject":{"entity_id":"ent_demo_001","country":"US","jurisdiction":"US-DE"},"result":{"supplier_id":"supplier_demo_001","supplier_authorization_id":"auth_demo_001","approval_limits":{"spend_band":"MEDIUM","valid_until":"2026-07-20T12:00:00Z","conditions":[]},"supplier_status":"APPROVED"}}}}}}},"400":{"description":"Malformed or contradictory strict input; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}},"401":{"description":"Internal-mode authentication required; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}},"402":{"description":"Canonical x402 challenge containing the single composite quote.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"quote":{"type":"object","additionalProperties":false,"required":["quote_id","quote_digest","product","product_version","policy","price","price_version","checks_planned","checks_reused","coverage","sellability","source_health_digest","manifest_digest","request_digest","idempotency_digest","expires_at"],"properties":{"quote_id":{"type":"string","pattern":"^quote_[A-Za-z0-9_-]+$"},"quote_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"product":{"const":"us.supplier.approve.v1"},"product_version":{"const":"1.0.0"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"enum":["US_NEW_SUPPLIER_V1","US_FEDERAL_COUNTERPARTY_V1"]},"version":{"const":"1.0.0"}}},"price":{"type":"object","additionalProperties":false,"required":["amount","amount_atomic","asset","network"],"properties":{"amount":{"const":"0.20"},"amount_atomic":{"const":"200000"},"asset":{"const":"USDC"},"network":{"const":"eip155:8453"}}},"price_version":{"const":"1.0.0"},"checks_planned":{"type":"array","items":{"type":"string"},"maxItems":100},"checks_reused":{"type":"array","items":{"type":"string"},"maxItems":100},"coverage":{"type":"object","additionalProperties":true},"sellability":{"const":"SELLABLE"},"source_health_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"manifest_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"idempotency_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"expires_at":{"type":"string","format":"date-time"}}}}}}}},"409":{"description":"Idempotency, replay, request-material or state conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}},"413":{"description":"Payload exceeds the service body limit; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}},"422":{"description":"Invalid policy, unsupported coverage or unprocessable supplier material; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}},"424":{"description":"Mandatory capability, registry or source dependency unavailable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}},"503":{"description":"Product unsellable, source stale/unavailable, incomplete decision or retry later; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}}}}},"/v1/us/invoices/verify-payee":{"post":{"operationId":"verify_invoice_and_payee","summary":"Verify Invoice & Payee","tags":["invoice-payee-verification"],"description":"Verifies that an invoice belongs to the resolved federal supplier and that the declared business payee is bound to that supplier. In an activated federal runtime, a complete deliverable decision is sold for 0.10 USDC through x402; failures and durable replays are not charged.","x-product-id":"us.invoice_payee.verify.v1","x-solution":"INVOICE_PAYEE_VERIFICATION","x-policy":{"id":"US_INVOICE_PAYEE_VERIFICATION_V1","version":"1.0.0"},"x-price":{"amount":"0.10","amount_atomic":"100000","asset":"USDC","network":"eip155:8453","price_version":"1.0.0","billing_mode":"COMPOSITE_SINGLE_CHARGE","primitive_billing":"DISABLED","economically_active":true},"x-mcp":{"tool":"verify_invoice_and_payee","publication":"PREPARED_NOT_PUBLISHED"},"x-x402":{"active":"RUNTIME_GATED","version":2,"paymentHeader":"PAYMENT-SIGNATURE","network":"eip155:8453","price":"0.10","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-idempotency":{"header":"Idempotency-Key","required":true,"durable":true,"identicalPayloadRequired":true},"x-replay":{"deterministic":true,"externalSourcesQueried":false,"additionalCharge":false,"signerInvocations":0,"redactionPreserved":true},"x-no-charge":["INVALID_INPUT","UNSUPPORTED_COVERAGE","SOURCE_STALE","SOURCE_UNAVAILABLE","AMBIGUOUS_IDENTITY","INSUFFICIENT_EVIDENCE","INTERNAL_FAILURE","TECHNICAL_STAGING"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$id":"InvoicePayeeVerificationRequestV1","type":"object","additionalProperties":false,"required":["schema_version","policy_id","subject","invoice","payee","payment_context"],"properties":{"schema_version":{"const":"1.0.0"},"policy_id":{"const":"US_INVOICE_PAYEE_VERIFICATION_V1"},"subject":{"type":"object","additionalProperties":false,"required":["jurisdiction"],"anyOf":[{"required":["entity_id"]},{"required":["identifier"]}],"properties":{"entity_id":{"type":"string","minLength":1,"maxLength":160},"identifier":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI","EIN"]},"value":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"}}},"legal_name":{"type":"string","minLength":1,"maxLength":200},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"country":{"const":"US","default":"US"}}},"invoice":{"type":"object","additionalProperties":false,"required":["invoice_id","invoice_number","issue_date","currency","total_amount","supplier_legal_name"],"properties":{"invoice_id":{"type":"string","minLength":1,"maxLength":160},"invoice_number":{"type":"string","minLength":1,"maxLength":120},"issue_date":{"type":"string","format":"date"},"due_date":{"type":"string","format":"date"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"total_amount":{"type":"string","pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"supplier_legal_name":{"type":"string","minLength":1,"maxLength":200},"supplier_identifiers":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI","EIN"]},"value":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"}}},"default":[]},"billing_address":{"type":"object","additionalProperties":false,"required":["line1","locality","subdivision","postal_code","country"],"properties":{"line1":{"type":"string","minLength":1,"maxLength":200},"line2":{"type":"string","minLength":1,"maxLength":200},"locality":{"type":"string","minLength":1,"maxLength":120},"subdivision":{"type":"string","minLength":1,"maxLength":80},"postal_code":{"type":"string","minLength":1,"maxLength":24},"country":{"const":"US"}}},"remittance_information":{"type":"object","additionalProperties":false,"properties":{"legal_name":{"type":"string","minLength":1,"maxLength":200},"address":{"type":"object","additionalProperties":false,"required":["line1","locality","subdivision","postal_code","country"],"properties":{"line1":{"type":"string","minLength":1,"maxLength":200},"line2":{"type":"string","minLength":1,"maxLength":200},"locality":{"type":"string","minLength":1,"maxLength":120},"subdivision":{"type":"string","minLength":1,"maxLength":80},"postal_code":{"type":"string","minLength":1,"maxLength":24},"country":{"const":"US"}}},"opaque_reference":{"type":"string","minLength":1,"maxLength":160}}},"purchase_order":{"type":"string","minLength":1,"maxLength":160},"customer_identity":{"type":"object","additionalProperties":false,"required":["legal_name"],"properties":{"legal_name":{"type":"string","minLength":1,"maxLength":200},"identifier":{"type":"string","minLength":1,"maxLength":160}}},"document_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"metadata":{"type":"object","maxProperties":30,"additionalProperties":{"type":["string","number","boolean","null"],"maxLength":500}}}},"payee":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}}},"payee_evidence":{"type":"array","maxItems":30,"default":[],"items":{"type":"object","additionalProperties":false,"required":["assertion_id","type","claim_classification","evidence_digest"],"properties":{"assertion_id":{"type":"string","minLength":1,"maxLength":160},"type":{"enum":["OFFICIAL_RECORD","CALLER_PROVIDED_DOCUMENT","MERCHANT_ASSERTION","SUPPLIER_ASSERTION","INDEPENDENT_CONFIRMATION","PROVIDER_ATTESTATION","SIGNED_WALLET_CHALLENGE"]},"claim_classification":{"enum":["OBSERVED_FACT","NORMALIZED_FACT","INFERENCE","POLICY_OUTCOME"]},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"observed_at":{"type":"string","format":"date-time"}}}},"payee_challenge":{"type":"object","additionalProperties":false,"required":["method"],"properties":{"challenge_reference":{"type":"string","minLength":1,"maxLength":160},"challenge_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"method":{"enum":["PROVIDER_ATTESTATION","SIGNED_WALLET_CHALLENGE"]}}},"payment_context":{"type":"object","additionalProperties":false,"required":["amount_band"],"properties":{"amount_band":{"enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]},"destination_changed":{"type":"boolean","default":false},"duplicate_invoice_indicator":{"type":"boolean","default":false},"purchase_order_required":{"type":"boolean","default":false}}},"supplier_approval_token":{"type":"string","minLength":32,"maxLength":8192}}},"example":{"schema_version":"1.0.0","policy_id":"US_INVOICE_PAYEE_VERIFICATION_V1","subject":{"identifier":{"type":"STATE_ENTITY_NUMBER","value":"SYNTHETIC-0001"},"legal_name":"Synthetic Components LLC","jurisdiction":"US-FL"},"invoice":{"invoice_id":"synthetic-invoice-001","invoice_number":"SYN-001","issue_date":"2026-07-30","due_date":"2026-08-30","currency":"USD","total_amount":"1250.00","supplier_legal_name":"Synthetic Components LLC","supplier_identifiers":[{"type":"STATE_ENTITY_NUMBER","value":"SYNTHETIC-0001","jurisdiction":"US-FL"}],"purchase_order":"SYNTHETIC-PO-001"},"payee":{"type":"PROVIDER_ACCOUNT_TOKEN","value":"synthetic-opaque-destination-token","provider_namespace":"SYNTHETIC_PROCESSOR"},"payment_context":{"amount_band":"MEDIUM","destination_changed":false,"duplicate_invoice_indicator":false,"purchase_order_required":true}}}}},"responses":{"200":{"description":"Delivered decision. Activated economic delivery includes one reconciled 0.10 USDC charge; technical mode remains no-charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","product_version","request_id","request_digest","execution_id","policy","decision","machine_action","reason_codes","conditions","required_information","required_evidence","retry_after","checks_may_be_reused","invoice_match","payee_binding","supplier_approval","coverage","source_health","evidence_ids","evidence_bundle","quote","billing","delivery","replay","authorization_token","valid_as_of","valid_until"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"product_version":{"const":"1.0.0"},"request_id":{"type":"string"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"execution_id":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"const":"US_INVOICE_PAYEE_VERIFICATION_V1"},"version":{"const":"1.0.0"}}},"decision":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","UNDETERMINED"]},"machine_action":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","required_before_action"],"properties":{"code":{"type":"string"},"required_before_action":{"type":"boolean"}}}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"checks_may_be_reused":{"type":"boolean"},"invoice_match":{"type":["null","object"],"additionalProperties":true},"payee_binding":{"type":["null","object"],"additionalProperties":true},"supplier_approval":{"type":["null","object"],"additionalProperties":true},"coverage":{"type":"object","additionalProperties":true},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true}},"evidence_ids":{"type":"array","items":{"type":"string"}},"evidence_bundle":{"type":"object","additionalProperties":false,"required":["evidence_ids","decision_digest","limitations"],"properties":{"evidence_ids":{"type":"array","items":{"type":"string"}},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"limitations":{"type":"array","items":{"type":"string"}}}},"quote":{"type":"object","additionalProperties":true},"billing":{"type":"object","additionalProperties":true},"delivery":{"type":"object","additionalProperties":true},"replay":{"type":"object","additionalProperties":true},"authorization_token":{"type":"null"},"valid_as_of":{"type":["null","string"],"format":"date-time"},"valid_until":{"type":["null","string"],"format":"date-time"}}},"examples":{"sourceUnavailable":{"summary":"Fail-closed UNDETERMINED delivery","value":{"schema_version":"1.0.0","product":"us.invoice_payee.verify.v1","product_version":"1.0.0","request_id":"req_synthetic_outage","request_digest":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","execution_id":"orc_synthetic_outage","policy":{"id":"US_INVOICE_PAYEE_VERIFICATION_V1","version":"1.0.0"},"decision":"UNDETERMINED","machine_action":"RETRY_LATER","reason_codes":["SOURCE_UNAVAILABLE"],"conditions":[],"required_information":[],"required_evidence":[],"retry_after":"2026-07-30T12:05:00.000Z","checks_may_be_reused":true,"invoice_match":null,"payee_binding":null,"supplier_approval":null,"coverage":{"supported":true,"limitations":[]},"source_health":[{"source_id":"synthetic_registry","status":"UNAVAILABLE"}],"evidence_ids":[],"evidence_bundle":{"evidence_ids":[],"decision_digest":"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","limitations":["Mandatory source unavailable; no decision was inferred."]},"quote":{"quote_id":"quote_synthetic_outage","amount":"0.10","asset":"USDC","network":"eip155:8453","billing_mode":"COMPOSITE_SINGLE_CHARGE","primitive_billing":"DISABLED"},"billing":{"charged":false,"charge_reference":null,"no_charge_reason":"SOURCE_UNAVAILABLE","economic_mutations":0},"delivery":{"delivery_id":"delivery_synthetic_outage","status":"DELIVERED_TECHNICAL","result_digest":"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"},"replay":{"execution_id":"orc_synthetic_outage","replay_reference":"/v1/us/invoices/verify-payee/replays/orc_synthetic_outage","decision_digest":"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","additional_charge":false},"authorization_token":null,"valid_as_of":"2026-07-30T12:00:00.000Z","valid_until":"2026-07-30T12:05:00.000Z"}}}}}},"400":{"description":"Malformed strict request; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}},"example":{"schema_version":"1.0.0","product":"us.invoice_payee.verify.v1","request_id":"req_synthetic_invalid","error":{"code":"INVALID_INPUT","message":"The Invoice & Payee Verification request could not be delivered under the versioned contract."},"reason_codes":["INVALID_INPUT"],"required_information":[],"required_evidence":[],"retry_after":null,"charged":false}}}},"402":{"description":"Canonical x402 v2 challenge for exactly 0.10 USDC on Base when the federal offer is activated."},"409":{"description":"Idempotency or replay conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"410":{"description":"Supplier evidence token expired or revoked; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"413":{"description":"Payload exceeds service limit; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"415":{"description":"Content type is not application/json; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"422":{"description":"Missing or unsupported information; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"503":{"description":"Source stale/unavailable or mandatory execution incomplete; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}}}}},"/v1/us/invoices/verify-payee/replays/{executionId}":{"get":{"operationId":"replay_invoice_and_payee_verification","summary":"Replay a persisted Invoice & Payee Verification decision","tags":["invoice-payee-verification"],"description":"Returns the persisted, redacted replay for the execution. Historical replay does not query live sources, create a delivery, invoke a signer or create a charge.","x-product-id":"us.invoice_payee.verify.v1","x-policy":{"id":"US_INVOICE_PAYEE_VERIFICATION_V1","version":"1.0.0"},"x-replay":{"state":"PERSISTED","deterministic":true,"externalSourcesQueried":false,"additionalDelivery":false,"additionalCharge":false,"signerInvocations":0,"redactionPreserved":true},"x-idempotency":{"executionIdentityPersisted":true,"requestKeyNotRequired":true},"x-no-charge":true,"parameters":[{"name":"executionId","in":"path","required":true,"description":"Persisted orchestration execution ID.","schema":{"type":"string","pattern":"^orc_[0-9a-f]{32}$"},"example":"orc_11111111111111111111111111111111"}],"responses":{"200":{"description":"Persisted replay matched its decision and evidence digests; no live work or charge occurred.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","execution_id","replay_id","replay_digest","decision_digest","evidence_references","integrity_status","replay_state","sources_reexecuted","signer_invocations","additional_delivery","additional_charge","economic_mutations","redaction_preserved","metadata"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"execution_id":{"type":"string","pattern":"^orc_[0-9a-f]{32}$"},"replay_id":{"type":"string"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"evidence_references":{"type":"array","minItems":1,"items":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"integrity_status":{"const":"MATCH"},"replay_state":{"const":"PERSISTED"},"sources_reexecuted":{"const":false},"signer_invocations":{"const":0},"additional_delivery":{"const":false},"additional_charge":{"const":false},"economic_mutations":{"const":0},"redaction_preserved":{"const":true},"metadata":{"type":"object","additionalProperties":true}}},"example":{"schema_version":"1.0.0","product":"us.invoice_payee.verify.v1","execution_id":"orc_11111111111111111111111111111111","replay_id":"replay_synthetic_invoice","replay_digest":"sha256:2222222222222222222222222222222222222222222222222222222222222222","decision_digest":"sha256:3333333333333333333333333333333333333333333333333333333333333333","evidence_references":["sha256:4444444444444444444444444444444444444444444444444444444444444444"],"integrity_status":"MATCH","replay_state":"PERSISTED","sources_reexecuted":false,"signer_invocations":0,"additional_delivery":false,"additional_charge":false,"economic_mutations":0,"redaction_preserved":true,"metadata":{"request_digest":"sha256:5555555555555555555555555555555555555555555555555555555555555555","policy":{"id":"US_INVOICE_PAYEE_VERIFICATION_V1","version":"1.0.0"}}}}}},"400":{"description":"Malformed execution ID; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"404":{"description":"Replay not found; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"409":{"description":"Persisted replay digest conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"410":{"description":"Persisted reference expired or revoked; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"422":{"description":"Persisted execution is not replayable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}},"503":{"description":"Replay persistence dependency unavailable; no live source retry and no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}}}}}}}},"/v1/us/payments/authorize":{"post":{"operationId":"authorize_payment","summary":"Authorize a payment instruction without executing payment","tags":["payment-authorization"],"description":"Consumes valid Supplier Approval and Invoice & Payee evidence to decide whether a business payment instruction may proceed. It never executes the business payment itself. Activated federal delivery costs 0.20 USDC; incomplete evidence and replay remain no-charge.","x-product-id":"us.payment.authorize.v1","x-solution":"PAYMENT_AUTHORIZATION","x-policy":{"id":"US_PAYMENT_AUTHORIZATION_V1","version":"1.0.0"},"x-price":{"amount":"0.20","amount_atomic":"200000","asset":"USDC","network":"eip155:8453","price_version":"1.0.0","billing_mode":"COMPOSITE_SINGLE_CHARGE","primitive_billing":"DISABLED","economically_active":true},"x-x402":{"active":"RUNTIME_GATED","version":2,"paymentHeader":"PAYMENT-SIGNATURE","network":"eip155:8453","price":"0.20","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-idempotency":{"header":"Idempotency-Key","required":true,"durable":true},"x-replay":{"deterministic":true,"externalSourcesQueried":false,"additionalCharge":false,"signerInvocations":0},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$id":"PaymentAuthorizationRequestV1","type":"object","additionalProperties":false,"required":["schema_version","policy_id","payment_instruction","invoice_verification","supplier_approval_token","supplier","payee","amount","currency","payment_destination","jurisdiction","limits"],"properties":{"schema_version":{"const":"1.0.0"},"policy_id":{"const":"US_PAYMENT_AUTHORIZATION_V1"},"payment_instruction":{"type":"object","additionalProperties":false,"required":["instruction_id","instruction_digest"],"properties":{"instruction_id":{"type":"string","minLength":1,"maxLength":160},"instruction_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"purpose":{"type":"string","minLength":1,"maxLength":300}}},"invoice_verification":{"type":"object","additionalProperties":false,"required":["execution_id","decision_digest"],"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":160},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"supplier_approval_token":{"type":"string","minLength":32,"maxLength":8192},"supplier":{"type":"object","additionalProperties":false,"required":["entity_id","jurisdiction"],"properties":{"entity_id":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"}}},"payee":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}}},"amount":{"type":"string","pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"payment_destination":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}}},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"limits":{"type":"object","additionalProperties":false,"required":["amount_band"],"properties":{"amount_band":{"enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]},"limit_amount":{"type":"string","pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"destination_changed":{"type":"boolean","default":false},"approval_required":{"type":"boolean","default":false}}}}},"example":{"schema_version":"1.0.0","policy_id":"US_PAYMENT_AUTHORIZATION_V1","payment_instruction":{"instruction_id":"synthetic-payment-001","instruction_digest":"sha256:1111111111111111111111111111111111111111111111111111111111111111"},"invoice_verification":{"execution_id":"orc_22222222222222222222222222222222","decision_digest":"sha256:3333333333333333333333333333333333333333333333333333333333333333"},"supplier_approval_token":"synthetic-token-value-with-at-least-thirty-two-characters","supplier":{"entity_id":"usent_synthetic_supplier","jurisdiction":"US-FL"},"payee":{"type":"PROVIDER_ACCOUNT_TOKEN","value":"synthetic-opaque-destination","provider_namespace":"SYNTHETIC_PROCESSOR"},"amount":"1250.00","currency":"USD","payment_destination":{"type":"PROVIDER_ACCOUNT_TOKEN","value":"synthetic-opaque-destination","provider_namespace":"SYNTHETIC_PROCESSOR"},"jurisdiction":"US-FL","limits":{"amount_band":"MEDIUM","limit_amount":"5000.00","destination_changed":false,"approval_required":false}}}}},"responses":{"200":{"description":"Technical decision; payment is never executed.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product","product_version","request_id","request_digest","execution_id","policy","decision","machine_action","reason_codes","evidence_bundle","quote","billing","delivery","replay","payment_executed","authorization_token"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"product_version":{"const":"1.0.0"},"decision":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","UNDETERMINED"]},"machine_action":{"enum":["AUTHORIZE_PAYMENT","AUTHORIZE_WITH_LIMITS","HOLD_PAYMENT","REQUEST_ADDITIONAL_EVIDENCE","REQUEST_APPROVAL","BLOCK_PAYMENT","RETRY_LATER"]},"payment_executed":{"const":false},"authorization_token":{"type":"null"}}}}}},"400":{"description":"Invalid request; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}}}}},"402":{"description":"Canonical x402 v2 challenge for exactly 0.20 USDC on Base when the federal offer is activated."},"409":{"description":"Idempotency or replay conflict; no charge."},"410":{"description":"Referenced evidence expired or revoked; no charge."},"422":{"description":"Evidence mismatch or unsupported input; no charge."},"503":{"description":"Source stale/unavailable or technical mode disabled; no charge."}}}},"/v1/us/payments/authorize/replays/{executionId}":{"get":{"operationId":"replay_payment_authorization","summary":"Replay a persisted Payment Authorization decision","tags":["payment-authorization"],"description":"Returns the persisted, redacted authorization replay. It never executes payment, queries live sources, creates delivery, invokes a signer or creates a charge.","x-product-id":"us.payment.authorize.v1","x-policy":{"id":"US_PAYMENT_AUTHORIZATION_V1","version":"1.0.0"},"x-replay":{"state":"PERSISTED","deterministic":true,"externalSourcesQueried":false,"paymentExecuted":false,"additionalDelivery":false,"additionalCharge":false,"signerInvocations":0,"redactionPreserved":true},"x-idempotency":{"executionIdentityPersisted":true,"requestKeyNotRequired":true},"x-no-charge":true,"parameters":[{"name":"executionId","in":"path","required":true,"description":"Persisted orchestration execution ID.","schema":{"type":"string","pattern":"^orc_[0-9a-f]{32}$"},"example":"orc_44444444444444444444444444444444"}],"responses":{"200":{"description":"Persisted authorization replay matched its decision and evidence digests; no live work, payment or charge occurred.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","execution_id","replay_id","replay_digest","decision_digest","evidence_references","integrity_status","replay_state","sources_reexecuted","signer_invocations","additional_delivery","additional_charge","economic_mutations","redaction_preserved","payment_executed","metadata"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"execution_id":{"type":"string","pattern":"^orc_[0-9a-f]{32}$"},"replay_id":{"type":"string"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"evidence_references":{"type":"array","minItems":1,"items":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"integrity_status":{"const":"MATCH"},"replay_state":{"const":"PERSISTED"},"sources_reexecuted":{"const":false},"signer_invocations":{"const":0},"additional_delivery":{"const":false},"additional_charge":{"const":false},"economic_mutations":{"const":0},"redaction_preserved":{"const":true},"payment_executed":{"const":false},"metadata":{"type":"object","additionalProperties":true}}},"example":{"schema_version":"1.0.0","product":"us.payment.authorize.v1","execution_id":"orc_44444444444444444444444444444444","replay_id":"replay_synthetic_payment","replay_digest":"sha256:5555555555555555555555555555555555555555555555555555555555555555","decision_digest":"sha256:6666666666666666666666666666666666666666666666666666666666666666","evidence_references":["sha256:7777777777777777777777777777777777777777777777777777777777777777"],"integrity_status":"MATCH","replay_state":"PERSISTED","sources_reexecuted":false,"signer_invocations":0,"additional_delivery":false,"additional_charge":false,"economic_mutations":0,"redaction_preserved":true,"payment_executed":false,"metadata":{"request_digest":"sha256:8888888888888888888888888888888888888888888888888888888888888888","policy":{"id":"US_PAYMENT_AUTHORIZATION_V1","version":"1.0.0"}}}}}},"400":{"description":"Malformed execution ID; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}}}}},"404":{"description":"Replay not found; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}}}}},"409":{"description":"Persisted replay digest conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}}}}},"410":{"description":"Persisted reference expired or revoked; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}}}}},"422":{"description":"Persisted execution is not replayable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}}}}},"503":{"description":"Replay persistence dependency unavailable; no live source retry and no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}}}}}}}},"/v1/us/company-passports":{"post":{"tags":["company-capability-passport"],"x-product-id":"us.company.capability.passport.v1","x-policy":{"id":"US_COMPANY_CAPABILITY_PASSPORT_V1","version":"1.0.0"},"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.30","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","INSUFFICIENT_COVERAGE","STALE_EVIDENCE","REPLAY_MISMATCH"],"x-redaction":{"rawTokens":false,"rawInvoices":false,"bankData":false,"credentials":false,"personalData":false},"operationId":"create_company_capability_passport","summary":"Create or update an immutable Company Capability Passport","description":"Imports persisted, evidence-backed product decisions using deterministic precedence. Capability and authorization claims remain separate. Technical mode creates no charge or economic mutation.","x-idempotency":{"header":"Idempotency-Key","required":true,"durable":true,"conflictOnPayloadDrift":true},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$id":"CompanyCapabilityPassportCreateV1","type":"object","additionalProperties":false,"required":["schema_version","subject_entity_id","canonical_entity_identity","jurisdictions","decisions"],"properties":{"schema_version":{"const":"1.0.0"},"subject_entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"canonical_entity_identity":{"type":"object","additionalProperties":false,"required":["entity_id","display_name","registration_ref_digest"],"properties":{"entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"display_name":{"type":"string","minLength":1,"maxLength":200},"registration_ref_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"jurisdictions":{"type":"array","minItems":1,"maxItems":20,"uniqueItems":true,"items":{"type":"string","pattern":"^US-[A-Z]{2}$"}},"decisions":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["decision_ref","product_id","product_version","policy_id","policy_version","subject_entity_id","jurisdiction","issuer","audience","decision_digest","evidence_refs","coverage_status","source_health_status","revocation_status","valid_as_of","valid_until","capabilities","authorizations"],"properties":{"decision_ref":{"type":"string","pattern":"^dec_[A-Za-z0-9._:-]{6,150}$"},"product_id":{"enum":["us.company.check.v1","us.supplier.approve.v1","us.invoice_payee.verify.v1","us.payment.authorize.v1"]},"product_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"policy_id":{"type":"string","minLength":1,"maxLength":160},"policy_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"subject_entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"issuer":{"type":"string","minLength":1,"maxLength":160},"audience":{"type":"string","minLength":1,"maxLength":160},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"evidence_refs":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["evidence_id","evidence_digest","classification","valid_as_of","valid_until","status"],"properties":{"evidence_id":{"type":"string","pattern":"^ev_[A-Za-z0-9._:-]{6,150}$"},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"classification":{"enum":["SOURCE_OBSERVATION","NORMALIZED_FACT","INFERENCE","POLICY_RESULT","AUTHORIZATION_RESULT","LIMITATION"]},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"status":{"enum":["CURRENT","STALE","REVOKED","INVALID"]}}}},"coverage_status":{"enum":["SUFFICIENT","LIMITED","INSUFFICIENT","UNKNOWN"]},"source_health_status":{"enum":["HEALTHY","DEGRADED","UNAVAILABLE","UNKNOWN"]},"revocation_status":{"enum":["ACTIVE","REVOKED","INVALIDATED","SUPERSEDED"]},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"capabilities":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["capability_id","capability_version","status","scope","jurisdiction","confidence","risk_level"],"properties":{"capability_id":{"enum":["FEDERAL_COMPANY_GATE_EVALUATED","LEGAL_ENTITY_RESOLVED","LEGAL_STATUS_VERIFIED","SUPPLIER_APPROVED","INVOICE_COMPANY_MATCHED","PAYEE_BOUND","PAYMENT_ELIGIBLE","RIGHT_TO_TRANSACT","FRANCHISE_TAX_STATUS","RESTRICTED_PARTY_SCREENED","PAYMENT_DESTINATION_VERIFIED"]},"capability_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"status":{"enum":["VERIFIED","VERIFIED_WITH_CONDITIONS","SUPPORTED","CLAIMED","UNRESOLVED","NOT_AUTHORIZED","BLOCKED","STALE","REVOKED","UNDETERMINED"]},"scope":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US(?:-[A-Z]{2})?$"},"confidence":{"type":"number","minimum":0,"maximum":1},"risk_level":{"enum":["LOW","MEDIUM","HIGH","CRITICAL","UNKNOWN"]},"conditions":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"limitations":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"critical":{"type":"boolean"}}}},"authorizations":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["authorization_id","authorization_type","status","scope","subject","resource","amount_limit","currency","destination_scope","valid_as_of","valid_until"],"properties":{"authorization_id":{"type":"string","minLength":1,"maxLength":160},"authorization_type":{"enum":["SUPPLIER_USE","INVOICE_ACCEPTANCE","PAYEE_USE","PAYMENT_ELIGIBILITY","PAYMENT_DESTINATION_USE"]},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS","HOLD","BLOCKED","EXPIRED","REVOKED","UNDETERMINED"]},"scope":{"type":"string","minLength":1,"maxLength":160},"subject":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"resource":{"type":["string","null"],"maxLength":160},"amount_limit":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"destination_scope":{"type":["string","null"],"maxLength":160},"conditions":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"}}}},"risks":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"limitations":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}}}}}}}}}},"responses":{"201":{"description":"Immutable Passport version persisted.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["passport_id","passport_version","schema_version","subject_entity_id","status","capabilities","authorizations","evidence_refs","passport_digest","change_set","economic_mutations","redaction_applied"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"schema_version":{"const":"1.0.0"},"subject_entity_id":{"type":"string","minLength":1,"maxLength":160},"status":{"enum":["ACTIVE","ACTIVE_WITH_LIMITATIONS","REVIEW_REQUIRED","STALE","SUSPENDED","REVOKED","SUPERSEDED","UNDETERMINED"]},"capabilities":{"type":"array"},"authorizations":{"type":"array"},"evidence_refs":{"type":"array"},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"change_set":{"type":"object"},"economic_mutations":{"enum":[0,1]},"redaction_applied":{"const":true}}}}}},"400":{"description":"Malformed request; no charge."},"404":{"description":"Passport or version not found; no charge."},"409":{"description":"Idempotency, version or replay conflict; no charge."},"410":{"description":"Revoked Passport; no charge."},"422":{"description":"Decision, evidence, subject, scope, freshness or authorization binding rejected; no charge."},"503":{"description":"Technical mode disabled or persistence unavailable; no charge."}}}},"/v1/us/company-passports/{passportId}":{"get":{"tags":["company-capability-passport"],"x-product-id":"us.company.capability.passport.v1","x-policy":{"id":"US_COMPANY_CAPABILITY_PASSPORT_V1","version":"1.0.0"},"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.30","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","INSUFFICIENT_COVERAGE","STALE_EVIDENCE","REPLAY_MISMATCH"],"x-redaction":{"rawTokens":false,"rawInvoices":false,"bankData":false,"credentials":false,"personalData":false},"operationId":"get_company_capability_passport","summary":"Read the current Passport version","parameters":[{"name":"passportId","in":"path","required":true,"schema":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"}}],"responses":{"200":{"description":"Current immutable Passport snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["passport_id","passport_version","schema_version","subject_entity_id","status","capabilities","authorizations","evidence_refs","passport_digest","change_set","economic_mutations","redaction_applied"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"schema_version":{"const":"1.0.0"},"subject_entity_id":{"type":"string","minLength":1,"maxLength":160},"status":{"enum":["ACTIVE","ACTIVE_WITH_LIMITATIONS","REVIEW_REQUIRED","STALE","SUSPENDED","REVOKED","SUPERSEDED","UNDETERMINED"]},"capabilities":{"type":"array"},"authorizations":{"type":"array"},"evidence_refs":{"type":"array"},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"change_set":{"type":"object"},"economic_mutations":{"enum":[0,1]},"redaction_applied":{"const":true}}}}}},"400":{"description":"Malformed request; no charge."},"404":{"description":"Passport or version not found; no charge."},"409":{"description":"Idempotency, version or replay conflict; no charge."},"410":{"description":"Revoked Passport; no charge."},"422":{"description":"Decision, evidence, subject, scope, freshness or authorization binding rejected; no charge."},"503":{"description":"Technical mode disabled or persistence unavailable; no charge."}}}},"/v1/us/company-passports/{passportId}/versions/{version}":{"get":{"tags":["company-capability-passport"],"x-product-id":"us.company.capability.passport.v1","x-policy":{"id":"US_COMPANY_CAPABILITY_PASSPORT_V1","version":"1.0.0"},"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.30","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","INSUFFICIENT_COVERAGE","STALE_EVIDENCE","REPLAY_MISMATCH"],"x-redaction":{"rawTokens":false,"rawInvoices":false,"bankData":false,"credentials":false,"personalData":false},"operationId":"get_company_capability_passport_version","summary":"Read a specific immutable Passport version","parameters":[{"name":"passportId","in":"path","required":true,"schema":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"}},{"name":"version","in":"path","required":true,"schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}],"responses":{"200":{"description":"Historical immutable Passport snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["passport_id","passport_version","schema_version","subject_entity_id","status","capabilities","authorizations","evidence_refs","passport_digest","change_set","economic_mutations","redaction_applied"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"schema_version":{"const":"1.0.0"},"subject_entity_id":{"type":"string","minLength":1,"maxLength":160},"status":{"enum":["ACTIVE","ACTIVE_WITH_LIMITATIONS","REVIEW_REQUIRED","STALE","SUSPENDED","REVOKED","SUPERSEDED","UNDETERMINED"]},"capabilities":{"type":"array"},"authorizations":{"type":"array"},"evidence_refs":{"type":"array"},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"change_set":{"type":"object"},"economic_mutations":{"enum":[0,1]},"redaction_applied":{"const":true}}}}}},"400":{"description":"Malformed request; no charge."},"404":{"description":"Passport or version not found; no charge."},"409":{"description":"Idempotency, version or replay conflict; no charge."},"410":{"description":"Revoked Passport; no charge."},"422":{"description":"Decision, evidence, subject, scope, freshness or authorization binding rejected; no charge."},"503":{"description":"Technical mode disabled or persistence unavailable; no charge."}}}},"/v1/us/company-passports/{passportId}/replays/{version}":{"get":{"tags":["company-capability-passport"],"x-product-id":"us.company.capability.passport.v1","x-policy":{"id":"US_COMPANY_CAPABILITY_PASSPORT_V1","version":"1.0.0"},"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.30","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","INSUFFICIENT_COVERAGE","STALE_EVIDENCE","REPLAY_MISMATCH"],"x-redaction":{"rawTokens":false,"rawInvoices":false,"bankData":false,"credentials":false,"personalData":false},"operationId":"replay_company_capability_passport","summary":"Replay a Passport version without live work","description":"Recomputes the version digest from persisted redacted material. No source query, signing, version mutation or charge occurs.","x-replay":{"deterministic":true,"externalSourcesQueried":false,"signerInvocations":0,"versionsCreated":0,"additionalCharge":false},"parameters":[{"name":"passportId","in":"path","required":true,"schema":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"}},{"name":"version","in":"path","required":true,"schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}],"responses":{"200":{"description":"Replay MATCH.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["passport_id","passport_version","status","passport_digest","replay_digest","sources_queried","signer_invocations","versions_created","economic_mutations"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"status":{"enum":["MATCH","MISMATCH"]},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"sources_queried":{"const":0},"signer_invocations":{"const":0},"versions_created":{"const":0},"economic_mutations":{"const":0}}}}}},"400":{"description":"Malformed request; no charge."},"404":{"description":"Passport or version not found; no charge."},"409":{"description":"Idempotency, version or replay conflict; no charge."},"410":{"description":"Revoked Passport; no charge."},"422":{"description":"Decision, evidence, subject, scope, freshness or authorization binding rejected; no charge."},"503":{"description":"Technical mode disabled or persistence unavailable; no charge."}}}},"/v1/us/company-passports/{passportId}/refresh":{"post":{"tags":["company-capability-passport"],"x-product-id":"us.company.capability.passport.v1","x-policy":{"id":"US_COMPANY_CAPABILITY_PASSPORT_V1","version":"1.0.0"},"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.30","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","INSUFFICIENT_COVERAGE","STALE_EVIDENCE","REPLAY_MISMATCH"],"x-redaction":{"rawTokens":false,"rawInvoices":false,"bankData":false,"credentials":false,"personalData":false},"operationId":"refresh_company_capability_passport","summary":"Evaluate freshness and persist a selective refresh version","description":"Reuses current claims and selects only stale, expired or drifted checks. Manual/on-demand only; no scheduler or live source is invoked in technical certification.","parameters":[{"name":"passportId","in":"path","required":true,"schema":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","reason_code"],"properties":{"schema_version":{"const":"1.0.0"},"reason_code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{2,80}$"}}}}}},"responses":{"200":{"description":"Selective technical refresh persisted.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["passport_id","passport_version","schema_version","subject_entity_id","status","capabilities","authorizations","evidence_refs","passport_digest","change_set","economic_mutations","redaction_applied"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"schema_version":{"const":"1.0.0"},"subject_entity_id":{"type":"string","minLength":1,"maxLength":160},"status":{"enum":["ACTIVE","ACTIVE_WITH_LIMITATIONS","REVIEW_REQUIRED","STALE","SUSPENDED","REVOKED","SUPERSEDED","UNDETERMINED"]},"capabilities":{"type":"array"},"authorizations":{"type":"array"},"evidence_refs":{"type":"array"},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"change_set":{"type":"object"},"economic_mutations":{"enum":[0,1]},"redaction_applied":{"const":true}}}}}},"400":{"description":"Malformed request; no charge."},"404":{"description":"Passport or version not found; no charge."},"409":{"description":"Idempotency, version or replay conflict; no charge."},"410":{"description":"Revoked Passport; no charge."},"422":{"description":"Decision, evidence, subject, scope, freshness or authorization binding rejected; no charge."},"503":{"description":"Technical mode disabled or persistence unavailable; no charge."}}}},"/v1/us/company-passports/{passportId}/invalidate":{"post":{"tags":["company-capability-passport"],"x-product-id":"us.company.capability.passport.v1","x-policy":{"id":"US_COMPANY_CAPABILITY_PASSPORT_V1","version":"1.0.0"},"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.30","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","INSUFFICIENT_COVERAGE","STALE_EVIDENCE","REPLAY_MISMATCH"],"x-redaction":{"rawTokens":false,"rawInvoices":false,"bankData":false,"credentials":false,"personalData":false},"operationId":"invalidate_company_capability_passport","summary":"Revoke one authorization or the complete Passport","description":"Persists a new immutable version and a revocation record. Historical versions remain queryable but are never reusable as active authorization.","parameters":[{"name":"passportId","in":"path","required":true,"schema":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","reason_code","effective_at","source_ref"],"properties":{"schema_version":{"const":"1.0.0"},"reason_code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{2,80}$"},"authorization_id":{"type":"string","minLength":1,"maxLength":160},"effective_at":{"type":"string","format":"date-time"},"source_ref":{"type":"string","minLength":8,"maxLength":160}}}}}},"responses":{"200":{"description":"Revocation version persisted.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["passport_id","passport_version","schema_version","subject_entity_id","status","capabilities","authorizations","evidence_refs","passport_digest","change_set","economic_mutations","redaction_applied"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"schema_version":{"const":"1.0.0"},"subject_entity_id":{"type":"string","minLength":1,"maxLength":160},"status":{"enum":["ACTIVE","ACTIVE_WITH_LIMITATIONS","REVIEW_REQUIRED","STALE","SUSPENDED","REVOKED","SUPERSEDED","UNDETERMINED"]},"capabilities":{"type":"array"},"authorizations":{"type":"array"},"evidence_refs":{"type":"array"},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"change_set":{"type":"object"},"economic_mutations":{"enum":[0,1]},"redaction_applied":{"const":true}}}}}},"400":{"description":"Malformed request; no charge."},"404":{"description":"Passport or version not found; no charge."},"409":{"description":"Idempotency, version or replay conflict; no charge."},"410":{"description":"Revoked Passport; no charge."},"422":{"description":"Decision, evidence, subject, scope, freshness or authorization binding rejected; no charge."},"503":{"description":"Technical mode disabled or persistence unavailable; no charge."}}}},"/v1/us/vendors/authorizations/continue":{"post":{"tags":["continue-vendor-authorization"],"x-product-id":"us.vendor.authorization.continue.v1","x-policy":{"id":"US_CONTINUE_VENDOR_AUTHORIZATION_V1","version":"1.0.0"},"x-passport-dependency":true,"x-supplier-approval-dependency":true,"x-incremental-check-planner":true,"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.10","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","STALE_EVIDENCE","REPLAY_MISMATCH","SOURCE_UNAVAILABLE"],"x-redaction":{"rawTokens":false,"bankData":false,"credentials":false},"operationId":"continue_vendor_authorization","summary":"Decide whether a prior vendor authorization remains usable","description":"Validates the prior authorization and immutable Passport version, detects material drift, reuses compatible evidence, plans only incremental checks and issues a scoped technical continuation token. It never executes payment or queries sources during replay.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^idem_[A-Za-z0-9._:-]{4,110}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$id":"ContinueVendorAuthorizationRequestV1","type":"object","additionalProperties":false,"required":["schema_version","prior_authorization","passport_ref","supplier","current_action","current_context","policy_id","idempotency_key"],"properties":{"schema_version":{"const":"1.0.0"},"prior_authorization":{"type":"object","additionalProperties":false,"required":["kind","reference_id"],"properties":{"kind":{"enum":["SUPPLIER_APPROVAL_TOKEN","SUPPLIER_APPROVAL_EXECUTION","PASSPORT_AUTHORIZATION_CLAIM","DECISION_REFERENCE","AUTHORIZATION_ID"]},"reference_id":{"type":"string","minLength":6,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"compact_token":{"type":"string","minLength":32,"maxLength":8192}}},"passport_ref":{"type":"object","additionalProperties":false,"required":["passport_id","passport_version","passport_digest","authorization_id"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"authorization_id":{"type":"string","minLength":6,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"}}},"supplier":{"type":"object","additionalProperties":false,"required":["entity_id","jurisdiction","relationship","tenant_scope_fingerprint","caller_scope_fingerprint"],"properties":{"entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"relationship":{"type":"string","minLength":1,"maxLength":120},"tenant_scope_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"caller_scope_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"current_action":{"enum":["USE_SUPPLIER","ACCEPT_INVOICE","USE_PAYEE","AUTHORIZE_PAYMENT","CONTINUE_RECURRING_RELATIONSHIP"]},"current_context":{"type":"object","additionalProperties":false,"required":["environment","audience","legal_status","restricted_party_status","payee_digest","destination_digest","spend_band","amount","currency","evidence_digest","evidence_valid_until","coverage_status","source_health_status","changed_fields","requested_validity_seconds"],"properties":{"environment":{"enum":["staging","production","test"]},"audience":{"type":"string","minLength":6,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"legal_status":{"enum":["ACTIVE","INACTIVE","BLOCKED","UNKNOWN"]},"restricted_party_status":{"enum":["NO_MATCH_FOUND","POSSIBLE_MATCH","CONFIRMED_MATCH","INSUFFICIENT_EVIDENCE"]},"payee_digest":{"anyOf":[{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},{"type":"null"}]},"destination_digest":{"anyOf":[{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},{"type":"null"}]},"spend_band":{"enum":["LOW","MEDIUM","HIGH","ENTERPRISE"]},"amount":{"anyOf":[{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}]},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"evidence_valid_until":{"type":"string","format":"date-time"},"coverage_status":{"enum":["SUFFICIENT","LIMITED","INSUFFICIENT"]},"source_health_status":{"enum":["HEALTHY","DEGRADED","STALE","UNAVAILABLE"]},"changed_fields":{"type":"array","maxItems":30,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":80}},"requested_validity_seconds":{"type":"integer","minimum":60,"maximum":86400}}},"policy_id":{"const":"US_CONTINUE_VENDOR_AUTHORIZATION_V1"},"idempotency_key":{"type":"string","pattern":"^idem_[A-Za-z0-9._:-]{4,110}$"}}}}}},"responses":{"200":{"description":"Persisted continuation decision; a token is returned only for CONTINUE outcomes.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product","request_id","request_digest","idempotency_key","policy","supplier","prior_authorization_ref","passport_ref","decision","universal_decision","authorization","machine_action","changes_detected","checks_reused","checks_executed","checks_required","reason_codes","conditions","required_information","coverage","source_health","evidence_ids","valid_as_of","valid_until","continuation_authorization_token","replay_ref","charged","economic_mutations","redaction_applied","execution_digest"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"request_id":{"type":"string","minLength":6,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"idempotency_key":{"type":"string","minLength":6,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"decision":{"enum":["CONTINUE","CONTINUE_WITH_CONDITIONS","RECHECK","SUSPEND","BLOCK","INSUFFICIENT_EVIDENCE"]},"universal_decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","REJECT","INSUFFICIENT_EVIDENCE"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","RETRY_LATER"]},"machine_action":{"enum":["CONTINUE_VENDOR_USE","CONTINUE_WITH_LIMITS","RUN_INCREMENTAL_CHECKS","REQUEST_INFORMATION","REQUEST_DOCUMENT","REQUEST_PAYEE_CONFIRMATION","SUSPEND_VENDOR","BLOCK_VENDOR","RETRY_LATER"]},"charged":{"type":"boolean"},"economic_mutations":{"enum":[0,1]},"redaction_applied":{"const":true},"execution_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}}}}},"400":{"description":"Malformed strict input; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"404":{"description":"Prior authorization, Passport or execution not found; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"409":{"description":"Idempotency or replay conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"422":{"description":"Authorization, Passport, policy, subject, scope or token binding rejected; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"503":{"description":"Technical mode, signer, source or persistence unavailable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}}}}},"/v1/us/vendors/authorizations/continue/replays/{executionId}":{"get":{"tags":["continue-vendor-authorization"],"x-product-id":"us.vendor.authorization.continue.v1","x-policy":{"id":"US_CONTINUE_VENDOR_AUTHORIZATION_V1","version":"1.0.0"},"x-passport-dependency":true,"x-supplier-approval-dependency":true,"x-incremental-check-planner":true,"x-technical-mode":"SUPPORTED","x-x402":{"active":"RUNTIME_GATED","version":2,"network":"eip155:8453","price":"0.10","asset":"USDC","noDecisionNoCharge":true},"x-bazaar":{"active":"RUNTIME_GATED","discoveryExtension":"bazaar"},"x-no-charge":["INVALID_INPUT","STALE_EVIDENCE","REPLAY_MISMATCH","SOURCE_UNAVAILABLE"],"x-redaction":{"rawTokens":false,"bankData":false,"credentials":false},"operationId":"replay_continue_vendor_authorization","summary":"Replay a persisted continuation execution without side effects","parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","pattern":"^cvaexec_[0-9a-f]{32}$"}}],"responses":{"200":{"description":"Deterministic replay MATCH with zero live sources, signers, deliveries, Passport updates or economics.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["execution_id","status","execution_digest","replay_digest","sources_queried","signer_invocations","authorizations_created","deliveries_created","passport_updates","charges","economic_mutations"],"properties":{"execution_id":{"type":"string","pattern":"^cvaexec_[0-9a-f]{32}$"},"status":{"enum":["MATCH","MISMATCH"]},"execution_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"sources_queried":{"const":0},"signer_invocations":{"const":0},"authorizations_created":{"const":0},"deliveries_created":{"const":0},"passport_updates":{"const":0},"charges":{"const":0},"economic_mutations":{"const":0}}}}}},"400":{"description":"Malformed strict input; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"404":{"description":"Prior authorization, Passport or execution not found; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"409":{"description":"Idempotency or replay conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"422":{"description":"Authorization, Passport, policy, subject, scope or token binding rejected; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"503":{"description":"Technical mode, signer, source or persistence unavailable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.authorization.continue.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}}}}},"/v1/us/de/business-licenses/verify":{"post":{"operationId":"verify_delaware_business_license","summary":"Delaware Business License Verification","description":"Performs one low-frequency, on-demand lookup against Delaware Business Licenses dataset 5zy2-grhr, persists official evidence and returns a replayable limited decision.","tags":["delaware-business-license"],"x-product-id":"us.de.business_license.verify.v1","x-jurisdiction":"US-DE","x-capability":"DELAWARE_BUSINESS_LICENSE","x-corporate-registry-status":"UNSUPPORTED","x-payment-authorization":"HOLD","x-price":{"amount":"0.03","amount_atomic":"30000","asset":"USDC","network":"eip155:8453","version":"1.0.0"},"x-feature-flags":["US_DE_BUSINESS_LICENSE_PRODUCT_MODE","US_DE_BUSINESS_LICENSE_X402_MODE","US_DE_BUSINESS_LICENSE_BAZAAR_MODE"],"x-x402":{"version":2,"network":"eip155:8453","asset":"USDC","paymentHeader":"PAYMENT-SIGNATURE","oneChallenge":true,"oneSettlement":true},"x-idempotency":{"bodyField":"idempotency_key","required":true,"durable":true},"x-no-decision-no-charge":["invalid input","absence","ambiguity","stale source","source failure","schema drift","replay mismatch"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["lookup","policy_id","idempotency_key"],"properties":{"lookup":{"type":"object","additionalProperties":false,"minProperties":1,"maxProperties":1,"properties":{"legal_name":{"type":"string","minLength":2,"maxLength":300},"license_number":{"type":"string","pattern":"^[0-9]{1,32}$"}}},"policy_id":{"const":"US_DE_BUSINESS_LICENSE_VERIFICATION_V1"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}}}}},"responses":{"200":{"description":"Settled, replayable limited Delaware business-license decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","contract_version","product","solution","request_id","quote_id","request_digest","jurisdiction","capability","policy","decision","authorization","machine_action","confidence","risk_level","reason_codes","recommended_action","coverage","license","source","evidence_ids","replay","sellability","billing"],"properties":{"schema_version":{"const":"1.0.0"},"contract_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"solution":{"const":"DELAWARE_BUSINESS_LICENSE_VERIFICATION"},"request_id":{"type":"string"},"quote_id":{"type":"string"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"jurisdiction":{"const":"US-DE"},"capability":{"const":"DELAWARE_BUSINESS_LICENSE"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"const":"US_DE_BUSINESS_LICENSE_VERIFICATION_V1"},"version":{"const":"1.0.0"}}},"decision":{"type":"string","enum":["LICENSE_CURRENT","LICENSE_EXPIRED","LICENSE_FUTURE"]},"authorization":{"type":"string","enum":["ALLOW_LIMITED","HOLD"]},"machine_action":{"type":"string","enum":["USE_LICENSE_EVIDENCE_WITH_LIMITATIONS","HOLD"]},"confidence":{"type":"number","minimum":0,"maximum":1},"risk_level":{"type":"string","enum":["LOW","MEDIUM"]},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"recommended_action":{"type":"string"},"coverage":{"type":"object","additionalProperties":false,"required":["business_license","corporate_registry_status","limitations"],"properties":{"business_license":{"const":"LIMITED_AVAILABLE"},"corporate_registry_status":{"const":"UNSUPPORTED"},"limitations":{"type":"array","items":{"type":"string"},"minItems":1}}},"license":{"type":"object","additionalProperties":false,"required":["business_name","trade_name","category","license_number_digest","valid_from","valid_to","status"],"properties":{"business_name":{"type":"string"},"trade_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"license_number_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"valid_from":{"type":"string","format":"date-time"},"valid_to":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["CURRENT","EXPIRED","NOT_YET_VALID"]}}},"source":{"type":"object","additionalProperties":false,"required":["source_id","authority","dataset_id","dataset_title","attribution","metadata_license","freshness","source_updated_at","schema_version","parser_version"],"properties":{"source_id":{"const":"US_DE_DOF_BUSINESS_LICENSES"},"authority":{"const":"Delaware Department of Finance, Division of Revenue"},"dataset_id":{"const":"5zy2-grhr"},"dataset_title":{"const":"Delaware Business Licenses"},"attribution":{"const":"Delaware Department of Finance, Division of Revenue"},"metadata_license":{"const":"Public Domain"},"freshness":{"const":"CURRENT"},"source_updated_at":{"type":"string","format":"date-time"},"schema_version":{"const":"de_business_license_5zy2_grhr_schema_v1"},"parser_version":{"const":"de_business_license_directed_parser_v1"}}},"evidence_ids":{"type":"array","items":{"type":"string"},"minItems":1},"replay":{"type":"object","additionalProperties":false,"required":["reference","integrity"],"properties":{"reference":{"type":"string"},"integrity":{"const":"MATCH"}}},"sellability":{"const":"SELLABLE_WITH_LIMITATIONS"},"billing":{"type":"object","additionalProperties":false,"required":["price","network","asset","charge_reference","payment_authorization"],"properties":{"price":{"const":"0.03"},"network":{"const":"eip155:8453"},"asset":{"const":"USDC"},"charge_reference":{"type":"string"},"payment_authorization":{"const":"HOLD"}}}}}}}},"400":{"description":"Invalid input; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","decision","error","reason_codes","charged","corporate_registry_status","payment_authorization","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"request_id":{"type":"string"},"decision":{"const":"INSUFFICIENT_EVIDENCE"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"charged":{"const":false},"corporate_registry_status":{"const":"UNSUPPORTED"},"payment_authorization":{"const":"HOLD"},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"402":{"description":"Single x402 challenge after successful sellability preflight."},"409":{"description":"Ambiguous match or idempotency conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","decision","error","reason_codes","charged","corporate_registry_status","payment_authorization","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"request_id":{"type":"string"},"decision":{"const":"INSUFFICIENT_EVIDENCE"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"charged":{"const":false},"corporate_registry_status":{"const":"UNSUPPORTED"},"payment_authorization":{"const":"HOLD"},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"422":{"description":"No exact match or unsupported input; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","decision","error","reason_codes","charged","corporate_registry_status","payment_authorization","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"request_id":{"type":"string"},"decision":{"const":"INSUFFICIENT_EVIDENCE"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"charged":{"const":false},"corporate_registry_status":{"const":"UNSUPPORTED"},"payment_authorization":{"const":"HOLD"},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"429":{"description":"Conservative rate limit; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","decision","error","reason_codes","charged","corporate_registry_status","payment_authorization","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"request_id":{"type":"string"},"decision":{"const":"INSUFFICIENT_EVIDENCE"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"charged":{"const":false},"corporate_registry_status":{"const":"UNSUPPORTED"},"payment_authorization":{"const":"HOLD"},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"503":{"description":"Disabled, stale, unavailable, schema-incompatible or replay-invalid; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","decision","error","reason_codes","charged","corporate_registry_status","payment_authorization","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"request_id":{"type":"string"},"decision":{"const":"INSUFFICIENT_EVIDENCE"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"charged":{"const":false},"corporate_registry_status":{"const":"UNSUPPORTED"},"payment_authorization":{"const":"HOLD"},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"/v1/us/vendors/payment-details/authorize-change":{"post":{"tags":["vendor-payment-detail-change"],"x-product-id":"us.vendor.payment_detail_change.authorize.v1","x-price":{"amount":"0.15","asset":"USDC","active":false},"x-policy":{"id":"US_VENDOR_PAYMENT_DETAIL_CHANGE_V1","version":"1.0.0"},"x-supplier-approval-dependency":true,"x-passport-dependency":true,"x-continue-vendor-authorization-dependency":true,"x-current-proposed-payee-scope-separation":true,"x-single-use-token":true,"x-technical-mode":true,"x-x402":{"active":false},"x-bazaar":{"active":false},"x-no-charge":true,"x-redaction":{"rawTokens":false,"bankData":false,"credentials":false},"operationId":"authorize_vendor_payment_detail_change","summary":"Authorize a scoped current-to-proposed vendor payee change","description":"Validates prior authorization, Passport, independently scoped payee bindings, independent confirmation and dual control. It issues a short-lived single-use technical token and never authorizes or executes payment.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^idem_[A-Za-z0-9._:-]{4,110}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$id":"VendorPaymentDetailChangeCompletionRequestV1","type":"object","additionalProperties":false,"required":["schema_version","supplier","prior_authorization","passport_ref","current_payee","proposed_payee","change_reason","current_context","policy_id","idempotency_key"],"properties":{"schema_version":{"const":"1.0.0"},"supplier":{"type":"object","additionalProperties":false,"required":["entity_id","jurisdiction","relationship","tenant_scope_fingerprint","caller_scope_fingerprint","supplier_master_reference"],"properties":{"entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"relationship":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"tenant_scope_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"caller_scope_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"supplier_master_reference":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"}}},"prior_authorization":{"type":"object","additionalProperties":false,"required":["kind","reference_id"],"properties":{"kind":{"enum":["SUPPLIER_APPROVAL_TOKEN","CONTINUE_VENDOR_AUTHORIZATION_TOKEN","PASSPORT_AUTHORIZATION_CLAIM","AUTHORIZATION_ID","EXECUTION_REFERENCE","VENDOR_CHANGE_AUTHORIZATION"]},"reference_id":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"compact_token":{"type":"string","minLength":32,"maxLength":8192}}},"passport_ref":{"type":"object","additionalProperties":false,"required":["passport_id","passport_version","passport_digest","authorization_id"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"authorization_id":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"}}},"current_payee":{"type":"object","additionalProperties":false,"required":["payee_type","destination_digest","binding_reference","provider_namespace","valid_until","evidence_refs"],"properties":{"payee_type":{"enum":["PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN","WALLET","PAYTO"]},"destination_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_reference":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"provider_namespace":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"valid_until":{"type":"string","format":"date-time"},"evidence_refs":{"type":"array","maxItems":30,"uniqueItems":true,"items":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"}}}},"proposed_payee":{"type":"object","additionalProperties":false,"required":["payee_type","destination_digest","binding_reference","provider_namespace","valid_until","evidence_refs"],"properties":{"payee_type":{"enum":["PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN","WALLET","PAYTO"]},"destination_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_reference":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"provider_namespace":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"valid_until":{"type":"string","format":"date-time"},"evidence_refs":{"type":"array","maxItems":30,"uniqueItems":true,"items":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"}}}},"change_reason":{"enum":["SUPPLIER_REQUEST","ACCOUNT_REPLACEMENT","PROCESSOR_MIGRATION","WALLET_ROTATION","PAYTO_CHANGE","PAYOUT_DESTINATION_CHANGE","MERGER_OR_REORGANIZATION","ERROR_CORRECTION","SECURITY_INCIDENT","OTHER_SUPPORTED_REASON"]},"current_context":{"type":"object","additionalProperties":false,"required":["environment","audience","requested_action","amount","spend_band","currency","invoice_reference","purchase_order","relationship","requested_validity_seconds","independent_confirmation","dual_control","supplier_master_payee_digest","invoice_payee_digest","legal_status","restricted_party_status","coverage_status","source_health_status","evidence_complete","policy_context_digest"],"properties":{"environment":{"enum":["staging","production","test"]},"audience":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"requested_action":{"const":"UPDATE_VENDOR_PAYEE"},"amount":{"anyOf":[{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},{"type":"null"}]},"spend_band":{"enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}]},"invoice_reference":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"purchase_order":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"relationship":{"type":"string","minLength":4,"maxLength":160,"pattern":"^[A-Za-z0-9._:-]+$"},"requested_validity_seconds":{"enum":[900,3600,14400,86400]},"independent_confirmation":{"type":"object","additionalProperties":false,"required":["status","evidence_digest"],"properties":{"status":{"enum":["CONFIRMED","MISSING","FAILED"]},"evidence_digest":{"anyOf":[{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},{"type":"null"}]}}},"dual_control":{"type":"object","additionalProperties":false,"required":["status","approver_count","evidence_digest"],"properties":{"status":{"enum":["APPROVED","MISSING","REJECTED"]},"approver_count":{"type":"integer","minimum":0,"maximum":10},"evidence_digest":{"anyOf":[{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},{"type":"null"}]}}},"supplier_master_payee_digest":{"anyOf":[{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},{"type":"null"}]},"invoice_payee_digest":{"anyOf":[{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},{"type":"null"}]},"legal_status":{"enum":["ACTIVE","INACTIVE","BLOCKED","UNKNOWN"]},"restricted_party_status":{"enum":["NO_MATCH_FOUND","POSSIBLE_MATCH","CONFIRMED_MATCH","INSUFFICIENT_EVIDENCE"]},"coverage_status":{"enum":["SUFFICIENT","LIMITED","INSUFFICIENT"]},"source_health_status":{"enum":["HEALTHY","DEGRADED","STALE","UNAVAILABLE"]},"evidence_complete":{"type":"boolean"},"policy_context_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"policy_id":{"const":"US_VENDOR_PAYMENT_DETAIL_CHANGE_V1"},"idempotency_key":{"type":"string","pattern":"^idem_[A-Za-z0-9._:-]{4,110}$"}}}}}},"responses":{"200":{"description":"Persisted non-economic change decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product","request_id","request_digest","idempotency_key","policy","supplier","prior_authorization_ref","passport_ref","decision","universal_decision","authorization","machine_action","current_payee","proposed_payee","changes_detected","checks_reused","checks_executed","checks_required","reason_codes","conditions","required_information","coverage","source_health","evidence_ids","valid_as_of","valid_until","change_authorization_token","replay_ref","charged","economic_mutations","redaction_applied","execution_digest"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"decision":{"enum":["APPROVE_CHANGE","APPROVE_CHANGE_WITH_CONDITIONS","HOLD","BLOCK","REQUEST_INFORMATION","INSUFFICIENT_EVIDENCE"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","RETRY_LATER"]},"machine_action":{"enum":["UPDATE_VENDOR_PAYEE","UPDATE_WITH_LIMITS","REQUEST_INDEPENDENT_CONFIRMATION","REQUEST_DOCUMENT","REQUEST_DUAL_CONTROL_APPROVAL","HOLD_VENDOR_CHANGE","BLOCK_VENDOR_CHANGE","RETRY_LATER"]},"charged":{"const":false},"economic_mutations":{"const":0},"redaction_applied":{"const":true},"execution_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}}}}},"400":{"description":"Malformed strict request; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"404":{"description":"Canonical dependency or replay not found; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"409":{"description":"Idempotency, replay or token-use conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"422":{"description":"Prior authorization, payee scope, Passport or policy rejected.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"503":{"description":"Technical signer, source or persistence unavailable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}}}}},"/v1/us/vendors/payment-details/authorize-change/replays/{executionId}":{"get":{"tags":["vendor-payment-detail-change"],"x-product-id":"us.vendor.payment_detail_change.authorize.v1","x-price":{"amount":"0.15","asset":"USDC","active":false},"x-policy":{"id":"US_VENDOR_PAYMENT_DETAIL_CHANGE_V1","version":"1.0.0"},"x-supplier-approval-dependency":true,"x-passport-dependency":true,"x-continue-vendor-authorization-dependency":true,"x-current-proposed-payee-scope-separation":true,"x-single-use-token":true,"x-technical-mode":true,"x-x402":{"active":false},"x-bazaar":{"active":false},"x-no-charge":true,"x-redaction":{"rawTokens":false,"bankData":false,"credentials":false},"operationId":"replay_vendor_payment_detail_change","summary":"Replay a persisted change authorization without side effects","parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","pattern":"^vpdcexec_[0-9a-f]{32}$"}}],"responses":{"200":{"description":"Replay MATCH with zero sources, signer, token, delivery, payee mutation or economics.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["execution_id","status","execution_digest","replay_digest","sources_queried","signer_invocations","tokens_issued","tokens_consumed","deliveries_created","passport_updates","payee_bindings_changed","charges","economic_mutations"],"properties":{"execution_id":{"type":"string","pattern":"^vpdcexec_[0-9a-f]{32}$"},"status":{"enum":["MATCH","MISMATCH"]},"execution_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"sources_queried":{"const":0},"signer_invocations":{"const":0},"tokens_issued":{"const":0},"tokens_consumed":{"const":0},"deliveries_created":{"const":0},"passport_updates":{"const":0},"payee_bindings_changed":{"const":0},"charges":{"const":0},"economic_mutations":{"const":0}}}}}},"400":{"description":"Malformed strict request; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"404":{"description":"Canonical dependency or replay not found; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"409":{"description":"Idempotency, replay or token-use conflict; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"422":{"description":"Prior authorization, payee scope, Passport or policy rejected.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}},"503":{"description":"Technical signer, source or persistence unavailable; no charge.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.vendor.payment_detail_change.authorize.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}}}}}}}},"/v1/br/entities/resolve":{"post":{"operationId":"br_legal_entity_resolve_v1","summary":"Resolve Legal Entity. Brazil coverage. Policy BR_LEGAL_ENTITY_RESOLUTION_V1. Sources: BRASILAPI_RECEITA_FEDERAL. Resolut","description":"Resolve Legal Entity. Brazil coverage. Policy BR_LEGAL_ENTITY_RESOLUTION_V1. Sources: BRASILAPI_RECEITA_FEDERAL. Resolution is limited to Receita Federal-derived CNPJ fields available through the declared provider; it is not a universal identity guarantee.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"legal_name":{"type":"string","minLength":1,"maxLength":240},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","idempotency_key"]},"example":{"cnpj":"11222333000181","legal_name":"ACME BRASIL LTDA","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.legal_entity.resolve.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_LEGAL_ENTITY_RESOLUTION_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["BRASILAPI_RECEITA_FEDERAL"],"sources_unavailable":[],"limitations":["Resolution is limited to Receita Federal-derived CNPJ fields available through the declared provider; it is not a universal identity guarantee."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Resolution is limited to Receita Federal-derived CNPJ fields available through the declared provider; it is not a universal identity guarantee."],"remediation":[],"price_usdc":"0.01","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.01},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.legal_entity.resolve.v1","priceUsdc":"0.01","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/companies/legal-status":{"post":{"operationId":"br_company_legal_status_verify_v1","summary":"Verify Company Legal Status. Brazil coverage. Policy BR_COMPANY_LEGAL_STATUS_V1. Sources: BRASILAPI_RECEITA_FEDERAL. Reg","description":"Verify Company Legal Status. Brazil coverage. Policy BR_COMPANY_LEGAL_STATUS_V1. Sources: BRASILAPI_RECEITA_FEDERAL. Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","idempotency_key"]},"example":{"cnpj":"11222333000181","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.company.legal_status.verify.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_COMPANY_LEGAL_STATUS_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["BRASILAPI_RECEITA_FEDERAL"],"sources_unavailable":[],"limitations":["Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance."],"remediation":[],"price_usdc":"0.03","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.03},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.company.legal_status.verify.v1","priceUsdc":"0.03","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/invoices/match-company":{"post":{"operationId":"br_invoice_company_match_v1","summary":"Match Invoice to Company. Brazil coverage. Policy BR_INVOICE_COMPANY_MATCH_V1. Sources: BRASILAPI_RECEITA_FEDERAL, CALLE","description":"Match Invoice to Company. Brazil coverage. Policy BR_INVOICE_COMPANY_MATCH_V1. Sources: BRASILAPI_RECEITA_FEDERAL, CALLER_INVOICE_FIELDS. Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"invoice":{"type":"object","additionalProperties":false,"properties":{"invoice_id":{"type":"string","minLength":1,"maxLength":240},"supplier_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"supplier_legal_name":{"type":"string","minLength":1,"maxLength":240},"supplier_address":{"type":"string","minLength":1,"maxLength":240},"issue_date":{"type":"string","format":"date"},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},"currency":{"const":"BRL","default":"BRL"}},"required":["invoice_id","supplier_cnpj","supplier_legal_name"]},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","invoice","idempotency_key"]},"example":{"cnpj":"11222333000181","invoice":{"invoice_id":"INV-2026-001","supplier_cnpj":"11222333000181","supplier_legal_name":"ACME BRASIL LTDA","issue_date":"2026-08-10","amount":"100.00","currency":"BRL"},"idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.invoice.company.match.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_INVOICE_COMPANY_MATCH_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["BRASILAPI_RECEITA_FEDERAL","CALLER_INVOICE_FIELDS"],"sources_unavailable":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established."],"remediation":[],"price_usdc":"0.05","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.05},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.invoice.company.match.v1","priceUsdc":"0.05","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/payees/match-business":{"post":{"operationId":"br_business_payee_match_v1","summary":"Match Business Payee. Brazil coverage. Policy BR_BUSINESS_PAYEE_MATCH_V1. Sources: INDEPENDENT_PAYEE_BINDING_EVIDENCE. A","description":"Match Business Payee. Brazil coverage. Policy BR_BUSINESS_PAYEE_MATCH_V1. Sources: INDEPENDENT_PAYEE_BINDING_EVIDENCE. A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","payee_fingerprint","idempotency_key"]},"example":{"cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","binding_evidence":{"type":"INDEPENDENT_CONFIRMATION","reference":"provider-attestation-001","verified_at":"2026-08-10T10:00:00.000Z","valid_until":"2026-08-11T10:00:00.000Z","subject_cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.business_payee.match.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_BUSINESS_PAYEE_MATCH_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["INDEPENDENT_PAYEE_BINDING_EVIDENCE"],"sources_unavailable":[],"limitations":["A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions."],"remediation":[],"price_usdc":"0.05","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.05},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.business_payee.match.v1","priceUsdc":"0.05","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/suppliers/approve":{"post":{"operationId":"br_supplier_approve_v1","summary":"Approve Supplier. Brazil coverage. Policy BR_SUPPLIER_APPROVAL_V1. Sources: BRASILAPI_RECEITA_FEDERAL, CEIS, CNEP, CGU_L","description":"Approve Supplier. Brazil coverage. Policy BR_SUPPLIER_APPROVAL_V1. Sources: BRASILAPI_RECEITA_FEDERAL, CEIS, CNEP, CGU_LENIENCY, TCU_INIDONEOS, MTE_FORCED_LABOR. Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance. No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"policy_id":{"const":"BR_SUPPLIER_APPROVAL_V1"},"payee":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","payee_fingerprint"]},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","policy_id","idempotency_key"]},"example":{"cnpj":"11222333000181","policy_id":"BR_SUPPLIER_APPROVAL_V1","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.supplier.approve.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_SUPPLIER_APPROVAL_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["BRASILAPI_RECEITA_FEDERAL","CEIS","CNEP","CGU_LENIENCY","TCU_INIDONEOS","MTE_FORCED_LABOR"],"sources_unavailable":[],"limitations":["Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance.","No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance.","No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions."],"remediation":[],"price_usdc":"0.20","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.2},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.supplier.approve.v1","priceUsdc":"0.20","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/vendors/authorize-payment-detail-change":{"post":{"operationId":"br_vendor_payment_detail_change_authorize_v1","summary":"Authorize Vendor Payment-Detail Change. Brazil coverage. Policy BR_VENDOR_PAYMENT_DETAIL_CHANGE_V1. Sources: PRIOR_VERIF","description":"Authorize Vendor Payment-Detail Change. Brazil coverage. Policy BR_VENDOR_PAYMENT_DETAIL_CHANGE_V1. Sources: PRIOR_VERIFIED_AUTHORIZATION, INDEPENDENT_PAYEE_BINDING_EVIDENCE, BRASILAPI_RECEITA_FEDERAL, RESTRICTED_PARTY_SCREENING. A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions. Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"current_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"proposed_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"prior_authorization":{"type":"object","additionalProperties":false,"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":240},"valid_until":{"type":"string","format":"date-time"},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS"]}},"required":["execution_id","valid_until","status"]},"challenge":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization","idempotency_key"]},"example":{"cnpj":"11222333000181","current_payee_fingerprint":"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","proposed_payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","prior_authorization":{"execution_id":"brexec_prior_authorization_001","valid_until":"2026-08-11T10:00:00.000Z","status":"AUTHORIZED"},"challenge":{"type":"INDEPENDENT_CONFIRMATION","reference":"provider-attestation-001","verified_at":"2026-08-10T10:00:00.000Z","valid_until":"2026-08-11T10:00:00.000Z","subject_cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.vendor.payment_detail_change.authorize.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_VENDOR_PAYMENT_DETAIL_CHANGE_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["PRIOR_VERIFIED_AUTHORIZATION","INDEPENDENT_PAYEE_BINDING_EVIDENCE","BRASILAPI_RECEITA_FEDERAL","RESTRICTED_PARTY_SCREENING"],"sources_unavailable":[],"limitations":["A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."],"remediation":[],"price_usdc":"0.15","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.15},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.vendor.payment_detail_change.authorize.v1","priceUsdc":"0.15","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/payments/authorize":{"post":{"operationId":"br_business_payment_authorize_v1","summary":"Authorize Business Payment. Brazil coverage. Policy BR_PAYMENT_AUTHORIZATION_V1. Sources: SUPPLIER_APPROVAL, CALLER_INVO","description":"Authorize Business Payment. Brazil coverage. Policy BR_PAYMENT_AUTHORIZATION_V1. Sources: SUPPLIER_APPROVAL, CALLER_INVOICE_FIELDS, INDEPENDENT_PAYEE_BINDING_EVIDENCE, RESTRICTED_PARTY_SCREENING. Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established. A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions. Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"supplier":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"policy_id":{"const":"BR_SUPPLIER_APPROVAL_V1"},"payee":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","payee_fingerprint"]}},"required":["cnpj","policy_id"]},"invoice":{"type":"object","additionalProperties":false,"properties":{"invoice_id":{"type":"string","minLength":1,"maxLength":240},"supplier_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"supplier_legal_name":{"type":"string","minLength":1,"maxLength":240},"supplier_address":{"type":"string","minLength":1,"maxLength":240},"issue_date":{"type":"string","format":"date"},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},"currency":{"const":"BRL","default":"BRL"}},"required":["invoice_id","supplier_cnpj","supplier_legal_name"]},"payee":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","payee_fingerprint"]},"vendor_change":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"current_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"proposed_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"prior_authorization":{"type":"object","additionalProperties":false,"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":240},"valid_until":{"type":"string","format":"date-time"},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS"]}},"required":["execution_id","valid_until","status"]},"challenge":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization"]},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},"currency":{"const":"BRL"},"policy_id":{"const":"BR_PAYMENT_AUTHORIZATION_V1"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","supplier","invoice","payee","amount","currency","policy_id","idempotency_key"]},"example":{"cnpj":"11222333000181","supplier":{"cnpj":"11222333000181","policy_id":"BR_SUPPLIER_APPROVAL_V1"},"invoice":{"invoice_id":"INV-2026-001","supplier_cnpj":"11222333000181","supplier_legal_name":"ACME BRASIL LTDA","issue_date":"2026-08-10","amount":"100.00","currency":"BRL"},"payee":{"cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","binding_evidence":{"type":"INDEPENDENT_CONFIRMATION","reference":"provider-attestation-001","verified_at":"2026-08-10T10:00:00.000Z","valid_until":"2026-08-11T10:00:00.000Z","subject_cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}},"amount":"100.00","currency":"BRL","policy_id":"BR_PAYMENT_AUTHORIZATION_V1","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.business.payment.authorize.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_PAYMENT_AUTHORIZATION_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["SUPPLIER_APPROVAL","CALLER_INVOICE_FIELDS","INDEPENDENT_PAYEE_BINDING_EVIDENCE","RESTRICTED_PARTY_SCREENING"],"sources_unavailable":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established.","A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established.","A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."],"remediation":[],"price_usdc":"0.15","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.15},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.business.payment.authorize.v1","priceUsdc":"0.15","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/restricted-parties/screen":{"post":{"operationId":"br_restricted_business_party_screen_v1","summary":"Screen Restricted Business Party. Brazil coverage. Policy BR_RESTRICTED_BUSINESS_PARTY_V1. Sources: CEIS, CNEP, CGU_LENI","description":"Screen Restricted Business Party. Brazil coverage. Policy BR_RESTRICTED_BUSINESS_PARTY_V1. Sources: CEIS, CNEP, CGU_LENIENCY, TCU_INIDONEOS, MTE_FORCED_LABOR. No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"legal_name":{"type":"string","minLength":1,"maxLength":240},"aliases":{"type":"array","maxItems":20,"default":[],"items":{"type":"string","minLength":1,"maxLength":240}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","idempotency_key"]},"example":{"cnpj":"11222333000181","legal_name":"ACME BRASIL LTDA","aliases":[],"idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.restricted_business_party.screen.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_RESTRICTED_BUSINESS_PARTY_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["CEIS","CNEP","CGU_LENIENCY","TCU_INIDONEOS","MTE_FORCED_LABOR"],"sources_unavailable":[],"limitations":["No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions."],"remediation":[],"price_usdc":"0.01","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.01},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.restricted_business_party.screen.v1","priceUsdc":"0.01","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/vendors/authorizations/continue":{"post":{"operationId":"br_vendor_authorization_continue_v1","summary":"Continue Vendor Authorization. Brazil coverage. Policy BR_CONTINUE_VENDOR_AUTHORIZATION_V1. Sources: PRIOR_VERIFIED_AUTH","description":"Continue Vendor Authorization. Brazil coverage. Policy BR_CONTINUE_VENDOR_AUTHORIZATION_V1. Sources: PRIOR_VERIFIED_AUTHORIZATION, BRASILAPI_RECEITA_FEDERAL, RESTRICTED_PARTY_SCREENING. Only still-valid compatible claims are reused; stale, changed, revoked or policy-required claims are rechecked. Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"previous_authorization":{"type":"object","additionalProperties":false,"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":240},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS","SUSPENDED","REVOKED"]},"valid_until":{"type":"string","format":"date-time"},"claims":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"claim_id":{"type":"string","minLength":1,"maxLength":240},"type":{"enum":["LEGAL_ENTITY","LEGAL_STATUS","RESTRICTED_PARTY","PAYEE_BINDING","SUPPLIER_APPROVAL"]},"status":{"enum":["VALID","STALE","REVOKED"]},"valid_until":{"type":"string","format":"date-time"},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["claim_id","type","status","valid_until","evidence_digest"]}}},"required":["execution_id","status","valid_until","claims"]},"changed_claims":{"type":"array","maxItems":50,"default":[],"items":{"type":"string","minLength":1,"maxLength":240}},"policy_id":{"const":"BR_CONTINUE_VENDOR_AUTHORIZATION_V1"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","previous_authorization","policy_id","idempotency_key"]},"example":{"cnpj":"11222333000181","previous_authorization":{"execution_id":"brexec_prior_authorization_001","status":"AUTHORIZED","valid_until":"2026-08-11T10:00:00.000Z","claims":[{"claim_id":"legal-status","type":"LEGAL_STATUS","status":"VALID","valid_until":"2026-08-11T10:00:00.000Z","evidence_digest":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}]},"changed_claims":[],"policy_id":"BR_CONTINUE_VENDOR_AUTHORIZATION_V1","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.vendor.authorization.continue.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_CONTINUE_VENDOR_AUTHORIZATION_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["PRIOR_VERIFIED_AUTHORIZATION","BRASILAPI_RECEITA_FEDERAL","RESTRICTED_PARTY_SCREENING"],"sources_unavailable":[],"limitations":["Only still-valid compatible claims are reused; stale, changed, revoked or policy-required claims are rechecked.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Only still-valid compatible claims are reused; stale, changed, revoked or policy-required claims are rechecked.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."],"remediation":[],"price_usdc":"0.15","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.15},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.vendor.authorization.continue.v1","priceUsdc":"0.15","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/solutions/company-check":{"post":{"operationId":"br_solution_company_check_v1","summary":"Company Check. Brazil coverage. Policy BR_COMPANY_CHECK_V1. Sources: BRASILAPI_RECEITA_FEDERAL. Resolution is limited to","description":"Company Check. Brazil coverage. Policy BR_COMPANY_CHECK_V1. Sources: BRASILAPI_RECEITA_FEDERAL. Resolution is limited to Receita Federal-derived CNPJ fields available through the declared provider; it is not a universal identity guarantee. Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","idempotency_key"]},"example":{"cnpj":"11222333000181","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.solution.company_check.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_COMPANY_CHECK_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["BRASILAPI_RECEITA_FEDERAL"],"sources_unavailable":[],"limitations":["Resolution is limited to Receita Federal-derived CNPJ fields available through the declared provider; it is not a universal identity guarantee.","Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Resolution is limited to Receita Federal-derived CNPJ fields available through the declared provider; it is not a universal identity guarantee.","Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance."],"remediation":[],"price_usdc":"0.04","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.04},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.solution.company_check.v1","priceUsdc":"0.04","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/solutions/supplier-approval":{"post":{"operationId":"br_solution_supplier_approval_v1","summary":"Supplier Approval. Brazil coverage. Policy BR_SUPPLIER_APPROVAL_V1. Sources: BRASILAPI_RECEITA_FEDERAL, RESTRICTED_PARTY","description":"Supplier Approval. Brazil coverage. Policy BR_SUPPLIER_APPROVAL_V1. Sources: BRASILAPI_RECEITA_FEDERAL, RESTRICTED_PARTY_SCREENING. Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance. No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"policy_id":{"const":"BR_SUPPLIER_APPROVAL_V1"},"payee":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","payee_fingerprint"]},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","policy_id","idempotency_key"]},"example":{"cnpj":"11222333000181","policy_id":"BR_SUPPLIER_APPROVAL_V1","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.solution.supplier_approval.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_SUPPLIER_APPROVAL_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["BRASILAPI_RECEITA_FEDERAL","RESTRICTED_PARTY_SCREENING"],"sources_unavailable":[],"limitations":["Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance.","No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Registration status is an observed Receita Federal status, not universal good standing, solvency, licensing or tax clearance.","No finding is limited to the named completed CEIS, CNEP, leniency, TCU and MTE sources; public restrictions are not all called sanctions."],"remediation":[],"price_usdc":"0.20","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.2},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.solution.supplier_approval.v1","priceUsdc":"0.20","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/solutions/invoice-payee-verification":{"post":{"operationId":"br_solution_invoice_payee_verification_v1","summary":"Invoice & Payee Verification. Brazil coverage. Policy BR_INVOICE_PAYEE_VERIFICATION_V1. Sources: BRASILAPI_RECEITA_FEDER","description":"Invoice & Payee Verification. Brazil coverage. Policy BR_INVOICE_PAYEE_VERIFICATION_V1. Sources: BRASILAPI_RECEITA_FEDERAL, CALLER_INVOICE_FIELDS, INDEPENDENT_PAYEE_BINDING_EVIDENCE. Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established. A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"invoice":{"type":"object","additionalProperties":false,"properties":{"invoice_id":{"type":"string","minLength":1,"maxLength":240},"supplier_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"supplier_legal_name":{"type":"string","minLength":1,"maxLength":240},"supplier_address":{"type":"string","minLength":1,"maxLength":240},"issue_date":{"type":"string","format":"date"},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},"currency":{"const":"BRL","default":"BRL"}},"required":["invoice_id","supplier_cnpj","supplier_legal_name"]},"payee":{"type":"object","additionalProperties":false,"properties":{"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["payee_fingerprint"]},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","invoice","payee","idempotency_key"]},"example":{"cnpj":"11222333000181","invoice":{"invoice_id":"INV-2026-001","supplier_cnpj":"11222333000181","supplier_legal_name":"ACME BRASIL LTDA","issue_date":"2026-08-10","amount":"100.00","currency":"BRL"},"payee":{"payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","binding_evidence":{"type":"INDEPENDENT_CONFIRMATION","reference":"provider-attestation-001","verified_at":"2026-08-10T10:00:00.000Z","valid_until":"2026-08-11T10:00:00.000Z","subject_cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}},"idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.solution.invoice_payee_verification.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_INVOICE_PAYEE_VERIFICATION_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["BRASILAPI_RECEITA_FEDERAL","CALLER_INVOICE_FIELDS","INDEPENDENT_PAYEE_BINDING_EVIDENCE"],"sources_unavailable":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established.","A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established.","A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions."],"remediation":[],"price_usdc":"0.09","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.09},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.solution.invoice_payee_verification.v1","priceUsdc":"0.09","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/solutions/payment-authorization":{"post":{"operationId":"br_solution_payment_authorization_v1","summary":"Payment Authorization. Brazil coverage. Policy BR_PAYMENT_AUTHORIZATION_V1. Sources: SUPPLIER_APPROVAL, CALLER_INVOICE_F","description":"Payment Authorization. Brazil coverage. Policy BR_PAYMENT_AUTHORIZATION_V1. Sources: SUPPLIER_APPROVAL, CALLER_INVOICE_FIELDS, INDEPENDENT_PAYEE_BINDING_EVIDENCE, RESTRICTED_PARTY_SCREENING. Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established. A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions. Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"supplier":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"policy_id":{"const":"BR_SUPPLIER_APPROVAL_V1"},"payee":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","payee_fingerprint"]}},"required":["cnpj","policy_id"]},"invoice":{"type":"object","additionalProperties":false,"properties":{"invoice_id":{"type":"string","minLength":1,"maxLength":240},"supplier_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"supplier_legal_name":{"type":"string","minLength":1,"maxLength":240},"supplier_address":{"type":"string","minLength":1,"maxLength":240},"issue_date":{"type":"string","format":"date"},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},"currency":{"const":"BRL","default":"BRL"}},"required":["invoice_id","supplier_cnpj","supplier_legal_name"]},"payee":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"binding_evidence":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","payee_fingerprint"]},"vendor_change":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"current_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"proposed_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"prior_authorization":{"type":"object","additionalProperties":false,"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":240},"valid_until":{"type":"string","format":"date-time"},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS"]}},"required":["execution_id","valid_until","status"]},"challenge":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]}},"required":["cnpj","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization"]},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,6})?$"},"currency":{"const":"BRL"},"policy_id":{"const":"BR_PAYMENT_AUTHORIZATION_V1"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","supplier","invoice","payee","amount","currency","policy_id","idempotency_key"]},"example":{"cnpj":"11222333000181","supplier":{"cnpj":"11222333000181","policy_id":"BR_SUPPLIER_APPROVAL_V1"},"invoice":{"invoice_id":"INV-2026-001","supplier_cnpj":"11222333000181","supplier_legal_name":"ACME BRASIL LTDA","issue_date":"2026-08-10","amount":"100.00","currency":"BRL"},"payee":{"cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","binding_evidence":{"type":"INDEPENDENT_CONFIRMATION","reference":"provider-attestation-001","verified_at":"2026-08-10T10:00:00.000Z","valid_until":"2026-08-11T10:00:00.000Z","subject_cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}},"amount":"100.00","currency":"BRL","policy_id":"BR_PAYMENT_AUTHORIZATION_V1","idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.solution.payment_authorization.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_PAYMENT_AUTHORIZATION_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["SUPPLIER_APPROVAL","CALLER_INVOICE_FIELDS","INDEPENDENT_PAYEE_BINDING_EVIDENCE","RESTRICTED_PARTY_SCREENING"],"sources_unavailable":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established.","A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["Only caller-supplied invoice identity fields are compared; authenticity, duplicate absence and tax validity are not established.","A valid independent binding is required; bank-account ownership is not inferred from names, invoices or payment instructions.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."],"remediation":[],"price_usdc":"0.25","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.25},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.solution.payment_authorization.v1","priceUsdc":"0.25","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/solutions/vendor-change-continuous-authorization":{"post":{"operationId":"br_solution_vendor_change_continuous_authorization_v1","summary":"Vendor Change & Continuous Authorization. Brazil coverage. Policy BR_VENDOR_CHANGE_CONTINUOUS_AUTHORIZATION_V1. Sources:","description":"Vendor Change & Continuous Authorization. Brazil coverage. Policy BR_VENDOR_CHANGE_CONTINUOUS_AUTHORIZATION_V1. Sources: PRIOR_VERIFIED_AUTHORIZATION, BRASILAPI_RECEITA_FEDERAL, RESTRICTED_PARTY_SCREENING, INDEPENDENT_PAYEE_BINDING_EVIDENCE. One composite decision and one charge cover the declared vendor-change intent. Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"current_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"proposed_payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"prior_authorization":{"type":"object","additionalProperties":false,"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":240},"valid_until":{"type":"string","format":"date-time"},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS"]}},"required":["execution_id","valid_until","status"]},"challenge":{"type":"object","additionalProperties":false,"properties":{"type":{"enum":["PROVIDER_ATTESTATION","INDEPENDENT_CONFIRMATION","SIGNED_CHALLENGE","PREVIOUSLY_VERIFIED_BINDING"]},"reference":{"type":"string","minLength":1,"maxLength":240},"verified_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"subject_cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"payee_fingerprint":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["type","reference","verified_at","valid_until","subject_cnpj","payee_fingerprint"]},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"previous_authorization":{"type":"object","additionalProperties":false,"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":240},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS","SUSPENDED","REVOKED"]},"valid_until":{"type":"string","format":"date-time"},"claims":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"claim_id":{"type":"string","minLength":1,"maxLength":240},"type":{"enum":["LEGAL_ENTITY","LEGAL_STATUS","RESTRICTED_PARTY","PAYEE_BINDING","SUPPLIER_APPROVAL"]},"status":{"enum":["VALID","STALE","REVOKED"]},"valid_until":{"type":"string","format":"date-time"},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"required":["claim_id","type","status","valid_until","evidence_digest"]}}},"required":["execution_id","status","valid_until","claims"]},"changed_claims":{"type":"array","maxItems":50,"default":[],"items":{"type":"string","minLength":1,"maxLength":240}}},"required":["cnpj","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization","previous_authorization","idempotency_key"]},"example":{"cnpj":"11222333000181","current_payee_fingerprint":"sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","proposed_payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","prior_authorization":{"execution_id":"brexec_prior_authorization_001","valid_until":"2026-08-11T10:00:00.000Z","status":"AUTHORIZED"},"challenge":{"type":"INDEPENDENT_CONFIRMATION","reference":"provider-attestation-001","verified_at":"2026-08-10T10:00:00.000Z","valid_until":"2026-08-11T10:00:00.000Z","subject_cnpj":"11222333000181","payee_fingerprint":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"previous_authorization":{"execution_id":"brexec_prior_authorization_001","status":"AUTHORIZED","valid_until":"2026-08-11T10:00:00.000Z","claims":[{"claim_id":"legal-status","type":"LEGAL_STATUS","status":"VALID","valid_until":"2026-08-11T10:00:00.000Z","evidence_digest":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}]},"changed_claims":[],"idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.solution.vendor_change_continuous_authorization.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_VENDOR_CHANGE_CONTINUOUS_AUTHORIZATION_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["PRIOR_VERIFIED_AUTHORIZATION","BRASILAPI_RECEITA_FEDERAL","RESTRICTED_PARTY_SCREENING","INDEPENDENT_PAYEE_BINDING_EVIDENCE"],"sources_unavailable":[],"limitations":["One composite decision and one charge cover the declared vendor-change intent.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["One composite decision and one charge cover the declared vendor-change intent.","Authorization is scoped to the declared policy, evidence, amount, destination and validity window; it does not execute payment."],"remediation":[],"price_usdc":"0.20","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.2},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.solution.vendor_change_continuous_authorization.v1","priceUsdc":"0.20","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/company-passports":{"post":{"operationId":"br_company_capability_passport_v1","summary":"RunOnProof Company Capability Passport. Brazil coverage. Policy BR_COMPANY_CAPABILITY_PASSPORT_V1. Sources: COMMITTED_BR","description":"RunOnProof Company Capability Passport. Brazil coverage. Policy BR_COMPANY_CAPABILITY_PASSPORT_V1. Sources: COMMITTED_BR_EXECUTIONS. A Passport is immutable reusable evidence state, not a score, seal, universal capability claim or perpetual authorization.","tags":["Brazil","RunOnProof canonical portfolio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"cnpj":{"type":"string","pattern":"^(?:\\d{14}|\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2})$"},"execution_ids":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","minLength":1,"maxLength":240}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}},"required":["cnpj","execution_ids","idempotency_key"]},"example":{"cnpj":"11222333000181","execution_ids":["brexec_settled_001"],"idempotency_key":"br-canonical-example-0001"}}}},"responses":{"200":{"description":"Evidence-backed terminal decision","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schema_version","product_or_solution","country","jurisdiction","request_id","execution_id","replayed","decision","authorization","machine_action","policy","reason_codes","coverage","freshness","evidence","limitations","remediation","price_usdc","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"country":{"const":"BR"},"jurisdiction":{"const":"BRAZIL"},"request_id":{"type":"string"},"execution_id":{"type":"string"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","BLOCK","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY","RETRY_LATER"]},"machine_action":{"type":"string"},"policy":{"type":"object"},"reason_codes":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"freshness":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"string"}},"price_usdc":{"type":"string"},"economic_activity":{"type":"object"},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number"}}},"result":{"type":"object"}}},"example":{"schema_version":"1.0.0","product_or_solution":"br.company.capability.passport.v1","country":"BR","jurisdiction":"BRAZIL","request_id":"brreq_example","execution_id":"brexec_example","replayed":false,"decision":"APPROVE","authorization":"ALLOW","machine_action":"USE_RESULT","policy":{"id":"BR_COMPANY_CAPABILITY_PASSPORT_V1","version":"1.0.0","digest":"sha256:0000000000000000000000000000000000000000000000000000000000000000"},"reason_codes":["SYNTHETIC_EXAMPLE"],"coverage":{"status":"SUFFICIENT","sources_completed":["COMMITTED_BR_EXECUTIONS"],"sources_unavailable":[],"limitations":["A Passport is immutable reusable evidence state, not a score, seal, universal capability claim or perpetual authorization."]},"freshness":{"status":"CURRENT","valid_as_of":"2026-08-10T00:00:00.000Z","valid_until":"2026-08-11T00:00:00.000Z"},"evidence":[],"limitations":["A Passport is immutable reusable evidence state, not a score, seal, universal capability claim or perpetual authorization."],"remediation":[],"price_usdc":"0.10","economic_activity":{"charged":true,"quote_created":true,"settlement_created":true},"payment":{"protocol":"x402","payment_status":"SETTLED","charged_price_usd":0.1},"result":{}}}}},"402":{"description":"x402 payment required when economic mode is active"},"409":{"description":"Idempotency conflict; no charge"},"422":{"description":"Invalid input; no charge"},"503":{"description":"Incomplete chain, stale or unavailable source; no decision and no charge"}},"x-oracle":{"country":"BR","jurisdiction":"BRAZIL","productId":"br.company.capability.passport.v1","priceUsdc":"0.10","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"noDecisionNoCharge":true,"replay":true,"idempotency":true}}},"/v1/br/company-passports/{passportId}":{"get":{"tags":["Brazil","Company Capability Passport"],"responses":{"200":{"description":"Immutable Passport lifecycle result; no live source call and no charge"},"404":{"description":"Passport or version not found"}},"x-economic":{"charged":false,"economicMutations":0},"operationId":"get_br_company_passport","summary":"Get latest immutable Brazil Passport version"}},"/v1/br/company-passports/{passportId}/versions/{version}":{"get":{"tags":["Brazil","Company Capability Passport"],"responses":{"200":{"description":"Immutable Passport lifecycle result; no live source call and no charge"},"404":{"description":"Passport or version not found"}},"x-economic":{"charged":false,"economicMutations":0},"operationId":"get_br_company_passport_version","summary":"Get an immutable Brazil Passport version"}},"/v1/br/company-passports/{passportId}/verify":{"get":{"tags":["Brazil","Company Capability Passport"],"responses":{"200":{"description":"Immutable Passport lifecycle result; no live source call and no charge"},"404":{"description":"Passport or version not found"}},"x-economic":{"charged":false,"economicMutations":0},"operationId":"verify_br_company_passport","summary":"Verify current Passport state without source calls"}},"/v1/br/company-passports/{passportId}/replays/{version}":{"get":{"tags":["Brazil","Company Capability Passport"],"responses":{"200":{"description":"Immutable Passport lifecycle result; no live source call and no charge"},"404":{"description":"Passport or version not found"}},"x-economic":{"charged":false,"economicMutations":0},"operationId":"replay_br_company_passport","summary":"Replay and verify an immutable Passport version","x-replay":{"sourcesQueried":0,"charges":0}}},"/v1/br/company-passports/{passportId}/refresh":{"post":{"tags":["Brazil","Company Capability Passport"],"responses":{"200":{"description":"Immutable Passport lifecycle result; no live source call and no charge"},"404":{"description":"Passport or version not found"}},"x-economic":{"charged":false,"economicMutations":0},"operationId":"refresh_br_company_passport","summary":"Refresh from the Passport's admitted committed executions","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["idempotency_key"],"properties":{"idempotency_key":{"type":"string"}}}}}}}},"/v1/br/company-passports/{passportId}/revoke":{"post":{"tags":["Brazil","Company Capability Passport"],"responses":{"200":{"description":"Immutable Passport lifecycle result; no live source call and no charge"},"404":{"description":"Passport or version not found"}},"x-economic":{"charged":false,"economicMutations":0},"operationId":"revoke_br_company_passport","summary":"Append an immutable revoked Passport version","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string"}}}}}}}},"/v1/gb/coverage":{"get":{"operationId":"get_uk_coverage","summary":"Public UK coverage and offer availability","tags":["United Kingdom"],"responses":{"200":{"description":"Machine-readable coverage, limitations and purchase eligibility"}},"x-economic":false}},"/v1/gb/source-health":{"get":{"operationId":"get_uk_source_health","summary":"Public Companies House and UKSL health/freshness","tags":["United Kingdom"],"responses":{"200":{"description":"Current source-specific health without secret or raw payload data"}},"x-economic":false}},"/v1/gb/entities/resolve":{"post":{"operationId":"gb_legal_entity_resolve_v1","summary":"Resolve UK Legal Entity","description":"Resolve a UK Companies House entity before onboarding or contracting. Use a company number, or a legal name with optional postcode, to obtain source-scoped identity candidates. Ambiguity returns REVIEW; it does not imply good standing.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"company_name":{"type":"string","minLength":2,"maxLength":300},"postal_code":{"type":"string","maxLength":20},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}},"anyOf":[{"required":["company_number"]},{"required":["company_name"]}]},"example":{"company_number":"00006400","idempotency_key":"bazaar_gb_legal_entity_resolve_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.01 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.legal_entity.resolve.v1","policy":"GB_LEGAL_ENTITY_RESOLUTION_V1","availability":"AVAILABLE","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.01","requiredSources":["UK_COMPANIES_HOUSE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/companies/legal-status":{"post":{"operationId":"gb_company_legal_status_verify_v1","summary":"Verify UK Company Legal Status","description":"Verify the current Companies House legal status, overdue filing indicators and recorded insolvency observations for a UK company. Use before onboarding or a material decision; the result is source-scoped, not a universal good-standing certificate.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","idempotency_key":"bazaar_gb_company_legal_status_verify_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.03 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.company.legal_status.verify.v1","policy":"GB_COMPANY_STATUS_V1","availability":"AVAILABLE","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.03","requiredSources":["UK_COMPANIES_HOUSE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/invoices/match-company":{"post":{"operationId":"gb_invoice_company_match_v1","summary":"Match Invoice to UK Company","description":"Compare UK invoice identity fields with Companies House before payment. Use to detect company-name or registered-postcode mismatches. This does not prove invoice authenticity or VAT registration, and UNKNOWN fields remain explicit.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"invoice_company_name":{"type":"string","minLength":1,"maxLength":300,"description":"Legal name printed on the invoice."},"invoice_address":{"type":"object","additionalProperties":false,"properties":{"line_1":{"type":"string","maxLength":300},"line_2":{"type":"string","maxLength":300},"locality":{"type":"string","maxLength":200},"postal_code":{"type":"string","maxLength":20},"country":{"type":"string","maxLength":80}}},"vat_number":{"type":"string","maxLength":20,"description":"Optional UK VAT number; this route does not independently verify VAT registration."},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","invoice_company_name":"THE GIRLS' DAY SCHOOL TRUST","idempotency_key":"bazaar_gb_invoice_company_match_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.05 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.invoice.company.match.v1","policy":"GB_INVOICE_COMPANY_MATCH_V1","availability":"AVAILABLE","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.05","requiredSources":["UK_COMPANIES_HOUSE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/payees/match-business":{"post":{"operationId":"gb_business_payee_match_v1","summary":"Match UK Business Payee","description":"Evaluate a time-bound caller or provider payee-binding control for a UK company. Use before paying a known supplier. It accepts opaque fingerprints only and does not independently prove bank-account ownership; missing evidence returns REVIEW.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","payee_fingerprint":"sha256:1111111111111111111111111111111111111111111111111111111111111111","binding_evidence":{"type":"CUSTOMER_CONFIRMATION","verified_at":"2026-08-11T12:00:00Z","valid_until":"2030-08-11T12:00:00Z","reference":"buyer-held-control-example"},"idempotency_key":"bazaar_gb_business_payee_match_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.05 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.business_payee.match.v1","policy":"GB_PAYEE_BINDING_V1","availability":"LIMITED","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.05","requiredSources":["INDEPENDENT_PAYEE_BINDING_EVIDENCE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/suppliers/approve":{"post":{"operationId":"gb_supplier_approve_v1","summary":"Approve UK Supplier","description":"Screen a UK supplier before onboarding using Companies House status and the UK Sanctions List under the declared policy. Use for a bounded vendor decision. APPROVE is policy- and source-scoped, never a universal compliance approval.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","policy_id","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"policy_id":{"type":"string","minLength":3,"maxLength":120,"description":"Declared onboarding policy, normally GB_NEW_SUPPLIER_V1."},"sanctions_subject_names":{"type":"array","maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":3,"maxLength":300}},"vat_number":{"type":"string","maxLength":20},"eori_number":{"type":"string","maxLength":30},"payee":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","policy_id":"GB_NEW_SUPPLIER_V1","idempotency_key":"bazaar_gb_supplier_approve_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.20 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.supplier.approve.v1","policy":"GB_NEW_SUPPLIER_V1","availability":"AVAILABLE","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.20","requiredSources":["UK_COMPANIES_HOUSE","UK_SANCTIONS_LIST"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/vendors/authorize-payment-detail-change":{"post":{"operationId":"gb_vendor_payment_detail_change_authorize_v1","summary":"Authorize UK Vendor Payment-Detail Change","description":"Authorize one UK vendor payment-detail change using current supplier controls, an existing authorization reference and a fresh independent challenge. Use before updating a payee record. The result is expiring and single-use; raw bank data is not accepted.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization_reference","challenge","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"current_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"proposed_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"prior_authorization_reference":{"type":"string","minLength":1,"maxLength":200,"description":"Reference to the currently approved vendor/payee binding."},"challenge":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","current_payee_fingerprint":"sha256:1111111111111111111111111111111111111111111111111111111111111111","proposed_payee_fingerprint":"sha256:2222222222222222222222222222222222222222222222222222222222222222","prior_authorization_reference":"buyer-held-prior-authorization","challenge":{"type":"CHALLENGE","verified_at":"2026-08-11T12:00:00Z","valid_until":"2030-08-11T12:00:00Z","reference":"buyer-held-control-example"},"idempotency_key":"bazaar_gb_vendor_payment_detail_change_authorize_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.15 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.vendor.payment_detail_change.authorize.v1","policy":"GB_VENDOR_CHANGE_V1","availability":"LIMITED","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.15","requiredSources":["UK_COMPANIES_HOUSE","UK_SANCTIONS_LIST","INDEPENDENT_PAYEE_BINDING_EVIDENCE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/payments/authorize":{"post":{"operationId":"gb_business_payment_authorize_v1","summary":"Authorize UK Business Payment","description":"Authorize one bounded UK company payment by composing supplier, invoice, payee and optional vendor-change gates. Use immediately before releasing a payment. Any incomplete, unavailable or mismatched gate returns HOLD or DENY, not approval.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","supplier","invoice","payee","amount","currency","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"supplier":{"type":"object","additionalProperties":false,"required":["company_number","policy_id"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"policy_id":{"type":"string","minLength":3,"maxLength":120,"description":"Declared onboarding policy, normally GB_NEW_SUPPLIER_V1."},"sanctions_subject_names":{"type":"array","maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":3,"maxLength":300}},"vat_number":{"type":"string","maxLength":20},"eori_number":{"type":"string","maxLength":30},"payee":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}}}}}},"invoice":{"type":"object","additionalProperties":false,"required":["company_number"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"invoice_company_name":{"type":"string","minLength":1,"maxLength":300,"description":"Legal name printed on the invoice."},"invoice_address":{"type":"object","additionalProperties":false,"properties":{"line_1":{"type":"string","maxLength":300},"line_2":{"type":"string","maxLength":300},"locality":{"type":"string","maxLength":200},"postal_code":{"type":"string","maxLength":20},"country":{"type":"string","maxLength":80}}},"vat_number":{"type":"string","maxLength":20,"description":"Optional UK VAT number; this route does not independently verify VAT registration."}}},"payee":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}}}},"vendor_change":{"type":"object","additionalProperties":false,"required":["company_number","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization_reference","challenge","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"current_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"proposed_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"prior_authorization_reference":{"type":"string","minLength":1,"maxLength":200,"description":"Reference to the currently approved vendor/payee binding."},"challenge":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","description":"Positive decimal payment amount in the declared currency; not the x402 fee."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency code for the business payment instruction."},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","supplier":{"company_number":"00006400","policy_id":"GB_NEW_SUPPLIER_V1"},"invoice":{"company_number":"00006400","invoice_company_name":"THE GIRLS' DAY SCHOOL TRUST"},"payee":{"company_number":"00006400","payee_fingerprint":"sha256:1111111111111111111111111111111111111111111111111111111111111111","binding_evidence":{"type":"CUSTOMER_CONFIRMATION","verified_at":"2026-08-11T12:00:00Z","valid_until":"2030-08-11T12:00:00Z","reference":"buyer-held-control-example"}},"amount":"1250.00","currency":"GBP","idempotency_key":"bazaar_gb_business_payment_authorize_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.15 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.business.payment.authorize.v1","policy":"GB_BUSINESS_PAYMENT_V1","availability":"LIMITED","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.15","requiredSources":["UK_COMPANIES_HOUSE","UK_SANCTIONS_LIST","INDEPENDENT_PAYEE_BINDING_EVIDENCE","CALLER_INVOICE_FIELDS"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/restricted-parties/screen":{"post":{"operationId":"restricted_business_party_screen_v1","summary":"Screen Restricted Business Party","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestrictedBusinessPartyRequest"}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"restricted_business_party.screen.v1","policy":"GB_RESTRICTED_BUSINESS_PARTY_SCREEN_V1","availability":"AVAILABLE","purchasable":false,"priceStatus":"CANONICAL","priceUsdc":null,"requiredSources":["UK_SANCTIONS_LIST"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/vendors/authorizations/continue":{"post":{"operationId":"vendor_authorization_continue_v1","summary":"Continue Vendor Authorization","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContinueVendorAuthorizationRequest"}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"vendor.authorization.continue.v1","policy":"GB_CONTINUE_VENDOR_AUTHORIZATION_V1","availability":"AVAILABLE","purchasable":false,"priceStatus":"CANONICAL","priceUsdc":null,"requiredSources":["UK_COMPANIES_HOUSE","UK_SANCTIONS_LIST","PRIOR_VERIFIED_AUTHORIZATION"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/company-passports":{"post":{"operationId":"create_uk_company_capability_passport","summary":"Create a UK Company Capability Passport from committed executions","tags":["United Kingdom","Passport"],"security":[{"UkPassportOperatorToken":[]},{"UkPassportOperatorBasic":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUkCompanyCapabilityPassportRequest"}}}},"responses":{"201":{"description":"Immutable Passport version issued from admitted committed UK decisions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyCapabilityPassport"}}}},"401":{"description":"Operator authentication required"},"403":{"description":"Operator credential invalid"},"409":{"description":"Idempotency or replay mismatch"},"422":{"description":"Invalid, expired, unhealthy, unsupported or unbound evidence; no charge"},"503":{"description":"Passport runtime unavailable; no charge"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"company.capability.passport.v1","policy":"GB_COMPANY_CAPABILITY_PASSPORT_V1","status":"TECHNICAL_CERTIFIED","availability":"AVAILABLE","purchasable":false,"priceUsdc":null,"requiredSources":["COMMITTED_UK_EXECUTIONS"],"replay":"/v1/gb/company-passports/{passportId}/replays/{version}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","authentication":"REQUIRED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":false,"limitations":["Only committed, current, entity-bound UK execution evidence is admitted","Caller/provider attestations remain explicitly scoped and are not independently reverified by the Passport","A Passport is not a universal seal or guarantee"]}}},"/v1/gb/invoices/assess-authenticity-duplication":{"post":{"operationId":"gb_invoice_authenticity_duplication_assess_v1","summary":"Assess UK Invoice Authenticity & Duplication","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.invoice.authenticity_duplication.assess.v1","policy":"GB_INVOICE_AUTHENTICITY_DUPLICATION_V1","availability":"LIMITED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["CALLER_INVOICE_DIGEST","CALLER_AUTHENTICITY_CONTROL"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/bank-accounts/verify-ownership":{"post":{"operationId":"gb_bank_account_ownership_verify_v1","summary":"Verify UK Bank Account Ownership","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.bank_account_ownership.verify.v1","policy":"GB_BANK_ACCOUNT_OWNERSHIP_V1","availability":"SOURCE_CONDITIONED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["ELIGIBLE_CONFIRMATION_OF_PAYEE_PROVIDER","UK_COMPANIES_HOUSE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/companies/detect-material-change":{"post":{"operationId":"gb_company_material_change_detect_v1","summary":"Detect Material UK Company Change","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.company.material_change.detect.v1","policy":"GB_COMPANY_MATERIAL_CHANGE_V1","availability":"LIMITED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["UK_COMPANIES_HOUSE","CALLER_BASELINE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/business-licences/verify":{"post":{"operationId":"gb_business_licence_verify_v1","summary":"Verify UK Business Licence","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.business_licence.verify.v1","policy":"GB_BUSINESS_LICENCE_V1","availability":"SOURCE_CONDITIONED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["SECTOR_SPECIFIC_LICENSING_AUTHORITY","UK_COMPANIES_HOUSE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/tax-registrations/verify":{"post":{"operationId":"gb_tax_registration_verify_v1","summary":"Verify UK Tax Registration","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.tax_registration.verify.v1","policy":"GB_TAX_REGISTRATION_V1","availability":"SOURCE_CONDITIONED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["HMRC_VAT_V2","UK_COMPANIES_HOUSE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/business-documents/validate":{"post":{"operationId":"gb_business_document_validate_v1","summary":"Validate UK Business Document","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.business_document.validate.v1","policy":"GB_BUSINESS_DOCUMENT_V1","availability":"LIMITED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["UK_COMPANIES_HOUSE_FILING_HISTORY"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/beneficial-ownership-control/verify":{"post":{"operationId":"gb_beneficial_ownership_control_verify_v1","summary":"Verify UK Beneficial Ownership & Control","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.beneficial_ownership_control.verify.v1","policy":"GB_BENEFICIAL_OWNERSHIP_CONTROL_V1","availability":"LIMITED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["UK_COMPANIES_HOUSE_PSC"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/evidence/assess-freshness":{"post":{"operationId":"gb_source_evidence_freshness_assess_v1","summary":"Assess UK Source & Evidence Freshness","tags":["United Kingdom"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Public non-economic UK decision envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkDecisionEnvelope"}}}},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.source_evidence_freshness.assess.v1","policy":"GB_SOURCE_EVIDENCE_FRESHNESS_V1","availability":"LIMITED","purchasable":false,"priceStatus":"HUMAN_DECISION_REQUIRED","priceUsdc":null,"requiredSources":["CALLER_EVIDENCE_ENVELOPES"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"SUPPORTED","technical":true,"economic":false,"x402":false,"bazaar":false,"discoverable":true,"limitations":["Source-scoped claims only","This offer is public but not sold through x402"]}}},"/v1/gb/solutions/company-check":{"post":{"operationId":"gb_solution_company_check_v1","summary":"UK Company Check","description":"Check a UK company by resolving its Companies House identity and verifying current legal-status and insolvency observations in one paid call. Use before onboarding or contracting. It reports filing limits and does not promise universal good standing.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"company_name":{"type":"string","minLength":2,"maxLength":300},"postal_code":{"type":"string","maxLength":20},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}},"anyOf":[{"required":["company_number"]},{"required":["company_name"]}]},"example":{"company_number":"00006400","idempotency_key":"bazaar_gb_solution_company_check_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.04 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.solution.company_check.v1","policy":"GB_COMPANY_CHECK_V1","availability":"AVAILABLE","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.04","requiredSources":["UK_COMPANIES_HOUSE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/solutions/supplier-approval":{"post":{"operationId":"gb_solution_supplier_approval_v1","summary":"UK Supplier Approval","description":"Approve or hold a UK supplier before onboarding by combining Companies House identity/status with UK Sanctions List screening under a declared policy. Use for vendor onboarding; the decision is source-conditioned and never a universal approval.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","policy_id","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"policy_id":{"type":"string","minLength":3,"maxLength":120,"description":"Declared onboarding policy, normally GB_NEW_SUPPLIER_V1."},"sanctions_subject_names":{"type":"array","maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":3,"maxLength":300}},"vat_number":{"type":"string","maxLength":20},"eori_number":{"type":"string","maxLength":30},"payee":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","policy_id":"GB_NEW_SUPPLIER_V1","idempotency_key":"bazaar_gb_solution_supplier_approval_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.20 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.solution.supplier_approval.v1","policy":"GB_NEW_SUPPLIER_V1","availability":"AVAILABLE","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.20","requiredSources":["UK_COMPANIES_HOUSE","UK_SANCTIONS_LIST"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/solutions/invoice-payee-verification":{"post":{"operationId":"gb_solution_invoice_payee_verification_v1","summary":"UK Invoice & Payee Verification","description":"Verify UK invoice-company consistency and a time-bound payee-binding control in one call before payment. Use when the invoice and payee are already known. It does not prove invoice authenticity or bank-account ownership.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["invoice","payee","idempotency_key"],"properties":{"invoice":{"type":"object","additionalProperties":false,"required":["company_number"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"invoice_company_name":{"type":"string","minLength":1,"maxLength":300,"description":"Legal name printed on the invoice."},"invoice_address":{"type":"object","additionalProperties":false,"properties":{"line_1":{"type":"string","maxLength":300},"line_2":{"type":"string","maxLength":300},"locality":{"type":"string","maxLength":200},"postal_code":{"type":"string","maxLength":20},"country":{"type":"string","maxLength":80}}},"vat_number":{"type":"string","maxLength":20,"description":"Optional UK VAT number; this route does not independently verify VAT registration."}}},"payee":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"invoice":{"company_number":"00006400","invoice_company_name":"THE GIRLS' DAY SCHOOL TRUST"},"payee":{"company_number":"00006400","payee_fingerprint":"sha256:1111111111111111111111111111111111111111111111111111111111111111","binding_evidence":{"type":"CUSTOMER_CONFIRMATION","verified_at":"2026-08-11T12:00:00Z","valid_until":"2030-08-11T12:00:00Z","reference":"buyer-held-control-example"}},"idempotency_key":"bazaar_gb_solution_invoice_payee_verification_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.09 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.solution.invoice_payee_verification.v1","policy":"GB_INVOICE_PAYEE_V1","availability":"LIMITED","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.09","requiredSources":["UK_COMPANIES_HOUSE","INDEPENDENT_PAYEE_BINDING_EVIDENCE","CALLER_INVOICE_FIELDS"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/solutions/payment-authorization":{"post":{"operationId":"gb_solution_payment_authorization_v1","summary":"UK Payment Authorization","description":"Authorize one UK business payment by composing supplier, invoice and payee controls into a single decision and settlement. Use immediately before payment release. Missing or source-conditioned evidence produces HOLD; the token is bounded and single-use.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company_number","supplier","invoice","payee","amount","currency","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"supplier":{"type":"object","additionalProperties":false,"required":["company_number","policy_id"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"policy_id":{"type":"string","minLength":3,"maxLength":120,"description":"Declared onboarding policy, normally GB_NEW_SUPPLIER_V1."},"sanctions_subject_names":{"type":"array","maxItems":25,"uniqueItems":true,"items":{"type":"string","minLength":3,"maxLength":300}},"vat_number":{"type":"string","maxLength":20},"eori_number":{"type":"string","maxLength":30},"payee":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}}}}}},"invoice":{"type":"object","additionalProperties":false,"required":["company_number"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"invoice_company_name":{"type":"string","minLength":1,"maxLength":300,"description":"Legal name printed on the invoice."},"invoice_address":{"type":"object","additionalProperties":false,"properties":{"line_1":{"type":"string","maxLength":300},"line_2":{"type":"string","maxLength":300},"locality":{"type":"string","maxLength":200},"postal_code":{"type":"string","maxLength":20},"country":{"type":"string","maxLength":80}}},"vat_number":{"type":"string","maxLength":20,"description":"Optional UK VAT number; this route does not independently verify VAT registration."}}},"payee":{"type":"object","additionalProperties":false,"required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"binding_evidence":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}}}},"vendor_change":{"type":"object","additionalProperties":false,"required":["company_number","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization_reference","challenge","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"current_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"proposed_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"prior_authorization_reference":{"type":"string","minLength":1,"maxLength":200,"description":"Reference to the currently approved vendor/payee binding."},"challenge":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","description":"Positive decimal payment amount in the declared currency; not the x402 fee."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency code for the business payment instruction."},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"company_number":"00006400","supplier":{"company_number":"00006400","policy_id":"GB_NEW_SUPPLIER_V1"},"invoice":{"company_number":"00006400","invoice_company_name":"THE GIRLS' DAY SCHOOL TRUST"},"payee":{"company_number":"00006400","payee_fingerprint":"sha256:1111111111111111111111111111111111111111111111111111111111111111","binding_evidence":{"type":"CUSTOMER_CONFIRMATION","verified_at":"2026-08-11T12:00:00Z","valid_until":"2030-08-11T12:00:00Z","reference":"buyer-held-control-example"}},"amount":"1250.00","currency":"GBP","idempotency_key":"bazaar_gb_solution_payment_authorization_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.25 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.solution.payment_authorization.v1","policy":"GB_BUSINESS_PAYMENT_V1","availability":"LIMITED","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.25","requiredSources":["UK_COMPANIES_HOUSE","UK_SANCTIONS_LIST","INDEPENDENT_PAYEE_BINDING_EVIDENCE","CALLER_INVOICE_FIELDS"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/solutions/vendor-change-continuous-authorization":{"post":{"operationId":"gb_solution_vendor_change_continuous_authorization_v1","summary":"UK Vendor Change & Continuous Authorization","description":"Authorize a scoped UK vendor payment-detail change with current company/sanctions controls and a fresh independent challenge. Use before changing the payee, then continue monitoring through separate technical controls. The authorization is expiring and single-use.","tags":["United Kingdom"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"description":"Must equal body idempotency_key on paid execution; omitted probes still receive the x402 challenge."},{"name":"X-CDO-Request-Body-Digest","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"description":"SHA-256 of the canonical JSON request body."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["change","idempotency_key"],"properties":{"change":{"type":"object","additionalProperties":false,"required":["company_number","current_payee_fingerprint","proposed_payee_fingerprint","prior_authorization_reference","challenge","idempotency_key"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"current_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"proposed_payee_fingerprint":{"type":"string","minLength":8,"maxLength":200,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."},"prior_authorization_reference":{"type":"string","minLength":1,"maxLength":200,"description":"Reference to the currently approved vendor/payee binding."},"challenge":{"type":"object","additionalProperties":false,"required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"reference":{"type":"string","minLength":1,"maxLength":200,"description":"Non-secret reference to the evidence held by the caller."}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"example":{"change":{"company_number":"00006400","current_payee_fingerprint":"sha256:1111111111111111111111111111111111111111111111111111111111111111","proposed_payee_fingerprint":"sha256:2222222222222222222222222222222222222222222222222222222222222222","prior_authorization_reference":"buyer-held-prior-authorization","challenge":{"type":"CHALLENGE","verified_at":"2026-08-11T12:00:00Z","valid_until":"2030-08-11T12:00:00Z","reference":"buyer-held-control-example"},"idempotency_key":"bazaar_gb_solution_vendor_change_continuous_authorization_v1"},"idempotency_key":"bazaar_gb_solution_vendor_change_continuous_authorization_v1"}}}},"responses":{"200":{"description":"Settled UK decision envelope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["schema_version","product_or_solution","request_id","decision","authorization","machine_action","policy","reason_codes","conditions","required_information","coverage","source_health","evidence","valid_as_of","valid_until","limitations","economic_activity","payment","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"request_id":{"type":"string"},"execution_id":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"},"delivery_id":{"type":"string","pattern":"^gbdel_[A-Za-z0-9]+$"},"replayed":{"type":"boolean"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","description":"Country, population and explicit coverage limitations."},"source_health":{"type":"object","additionalProperties":{"enum":["HEALTHY","STALE","UNAVAILABLE","SCHEMA_BREAK","DISABLED"]}},"evidence":{"type":"array","items":{"type":"object"},"description":"Source-scoped evidence references; absence is never a clean finding."},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"limitations":{"type":"array","items":{"type":"string"}},"economic_activity":{"type":"object","additionalProperties":false,"required":["charged","quote_created","settlement_created"],"properties":{"charged":{"const":true},"quote_created":{"const":true},"settlement_created":{"const":true}}},"payment":{"type":"object","required":["protocol","payment_status","charged_price_usd","network","asset"],"properties":{"protocol":{"const":"x402"},"payment_status":{"const":"SETTLED"},"charged_price_usd":{"type":"number","minimum":0},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"transaction_hash":{"type":"string"},"persistence_status":{"const":"PERSISTED"}}},"result":{"type":"object","description":"Offer-specific facts and machine-action inputs; interpret with decision, coverage and limitations."}}}}}},"400":{"description":"Paid attempt omitted required idempotency or request-body binding headers; no facilitator verify or settle is attempted."},"402":{"description":"Payment required: 0.20 USDC via x402 on Base"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid input; not charged"},"503":{"description":"Required official source unavailable or stale; never charged or converted to no-finding"}},"x-oracle":{"country":"GB","jurisdiction":"UNITED_KINGDOM","productId":"gb.solution.vendor_change_continuous_authorization.v1","policy":"GB_VENDOR_CHANGE_V1","availability":"LIMITED","purchasable":true,"priceStatus":"CANONICAL","priceUsdc":"0.20","requiredSources":["UK_COMPANIES_HOUSE","UK_SANCTIONS_LIST","INDEPENDENT_PAYEE_BINDING_EVIDENCE"],"optionalSources":["HMRC_VAT_V2","FIND_A_TENDER","FCA_REGISTER"],"replay":"/v1/gb/executions/{executionId}","idempotency":"REQUIRED_FOR_MUTABLE_AUTHORIZATION","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"limitations":["Source-scoped claims only","No valid decision means no settlement"]}}},"/v1/gb/company-passports/{passportId}":{"get":{"operationId":"get_uk_company_capability_passport","summary":"Get the latest immutable UK Passport version","tags":["United Kingdom","Passport"],"security":[{"UkPassportOperatorToken":[]},{"UkPassportOperatorBasic":[]}],"responses":{"200":{"description":"Latest Passport version"},"401":{"description":"Operator authentication required"},"403":{"description":"Operator credential invalid"},"404":{"description":"Passport not found"}}}},"/v1/gb/company-passports/{passportId}/versions/{version}":{"get":{"operationId":"get_uk_company_capability_passport_version","summary":"Get an immutable UK Passport version","tags":["United Kingdom","Passport"],"security":[{"UkPassportOperatorToken":[]},{"UkPassportOperatorBasic":[]}],"responses":{"200":{"description":"Requested Passport version"},"401":{"description":"Operator authentication required"},"403":{"description":"Operator credential invalid"},"404":{"description":"Version not found"}}}},"/v1/gb/company-passports/{passportId}/replays/{version}":{"get":{"operationId":"replay_uk_company_capability_passport","summary":"Replay a private UK Passport version without source calls or charging","tags":["United Kingdom","Passport"],"security":[{"UkPassportOperatorToken":[]},{"UkPassportOperatorBasic":[]}],"responses":{"200":{"description":"Replay MATCH"},"401":{"description":"Operator authentication required"},"403":{"description":"Operator credential invalid"},"409":{"description":"Replay mismatch"}},"x-replay":{"liveSourceCalls":0,"signerInvocations":0,"charges":0}}},"/v1/gb/company-passports/{passportId}/verify":{"get":{"operationId":"verify_uk_company_capability_passport","summary":"Publicly verify integrity, expiry, revocation and reusable capabilities","tags":["United Kingdom","Passport"],"security":[],"responses":{"200":{"description":"Privacy-minimized fail-closed lifecycle verification","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkCompanyCapabilityPassportVerification"}}}},"404":{"description":"Passport not found"},"409":{"description":"Replay mismatch"}},"x-replay":{"liveSourceCalls":0,"signerInvocations":0,"charges":0}}},"/v1/gb/company-passports/{passportId}/versions/{version}/verify":{"get":{"operationId":"verify_uk_company_capability_passport_version","summary":"Publicly verify one immutable UK Passport version","tags":["United Kingdom","Passport"],"security":[],"responses":{"200":{"description":"Privacy-minimized version-scoped fail-closed lifecycle verification"},"404":{"description":"Version not found"},"409":{"description":"Replay mismatch"}},"x-replay":{"liveSourceCalls":0,"signerInvocations":0,"charges":0}}},"/v1/gb/company-passports/{passportId}/updates":{"post":{"operationId":"update_uk_company_capability_passport","summary":"Issue a superseding immutable version from newly committed UK executions","tags":["United Kingdom","Passport"],"security":[{"UkPassportOperatorToken":[]},{"UkPassportOperatorBasic":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUkCompanyCapabilityPassportRequest"}}}},"responses":{"200":{"description":"New version with valid claims reused and changed claims replaced"},"401":{"description":"Operator authentication required"},"403":{"description":"Operator credential invalid"},"409":{"description":"Idempotency, entity binding or version conflict"},"410":{"description":"Revoked Passport cannot be updated"},"422":{"description":"Invalid or inadmissible evidence; no charge"}},"x-economic":false}},"/v1/gb/company-passports/{passportId}/refresh":{"post":{"operationId":"refresh_uk_company_capability_passport","summary":"Re-evaluate stored claim freshness and issue an immutable lifecycle version","tags":["United Kingdom","Passport"],"security":[{"UkPassportOperatorToken":[]},{"UkPassportOperatorBasic":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}],"responses":{"200":{"description":"New lifecycle version; no source calls"},"401":{"description":"Operator authentication required"},"403":{"description":"Operator credential invalid"},"409":{"description":"Idempotency conflict"},"422":{"description":"Invalid request; no charge"},"503":{"description":"Passport runtime unavailable; no charge"}},"x-replay":{"liveSourceCalls":0,"signerInvocations":0,"charges":0}}},"/v1/gb/company-passports/{passportId}/invalidate":{"post":{"operationId":"invalidate_uk_company_capability_passport","summary":"Invalidate a UK Passport and preserve an immutable revocation version","tags":["United Kingdom","Passport"],"security":[{"UkPassportOperatorToken":[]},{"UkPassportOperatorBasic":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}],"responses":{"200":{"description":"Revoked Passport version issued"},"401":{"description":"Operator authentication required"},"403":{"description":"Operator credential invalid"},"409":{"description":"Idempotency conflict"},"410":{"description":"Passport already revoked"},"422":{"description":"Invalid request; no charge"},"503":{"description":"Passport runtime unavailable; no charge"}},"x-economic":false}},"/v1/gb/executions/{executionId}":{"get":{"operationId":"replay_uk_execution","summary":"Replay a persisted UK delivery without live source calls, signing, or charging","tags":["United Kingdom"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","pattern":"^gbexec_[a-zA-Z0-9]+$"}}],"responses":{"200":{"description":"Byte-equivalent persisted semantic result"},"404":{"description":"Execution not found"}},"x-replay":{"liveSourceCalls":0,"signerInvocations":0,"charges":0}}},"/v1/gb/tokens/consume":{"post":{"operationId":"consume_uk_authorization_token","summary":"Atomically consume a UK single-use technical authorization token","tags":["United Kingdom"],"responses":{"200":{"description":"CONSUMED, ALREADY_CONSUMED, REVOKED, or UNKNOWN"}},"x-economic":false}}},"x-payment":{"protocol":"x402","asset":"USDC","network":"eip155:8453"},"components":{"schemas":{"CompanyCheckRequest":{"type":"object","additionalProperties":false,"required":["company","policy_id","idempotency_key"],"properties":{"company":{"type":"object","additionalProperties":false,"required":["identifier","legal_name","jurisdiction"],"properties":{"identifier":{"type":"object","additionalProperties":false,"required":["scheme","value","evidence_reference"],"properties":{"scheme":{"type":"string","enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI"]},"value":{"type":"string","minLength":1,"maxLength":160},"evidence_reference":{"type":"string","pattern":"^(?:https://[^?\\s#]+|canonical-entity:[A-Za-z0-9_-]+)$"}}},"legal_name":{"type":"string","minLength":1,"maxLength":500},"jurisdiction":{"type":"string","pattern":"^US(?:-[A-Z]{2})?$"},"entity_id":{"type":"string","pattern":"^ent_[A-Za-z0-9_-]+$"}}},"policy_id":{"const":"US_COMPANY_CHECK_V1"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}},"CompanyCheckResponse":{"type":"object","additionalProperties":false,"required":["schema_version","product","solution","solution_version","request_id","execution_id","quote_id","request_digest","policy","decision","authorization","machine_action","confidence","risk_level","reason_codes","conditions","required_information","company","ambiguity","checks_executed","checks_reused","coverage","source_health","evidence_ids","freshness","limitations","valid_as_of","valid_until","authorization_token","charged","billing","delivery"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"solution":{"const":"COMPANY_CHECK"},"solution_version":{"const":"1.0.0"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"execution_id":{"type":"string","minLength":1},"quote_id":{"type":"string","minLength":1},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"const":"US_COMPANY_CHECK_V1"},"version":{"const":"1.0.0"}}},"decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","REVIEW","REJECT","INSUFFICIENT_EVIDENCE"]},"authorization":{"type":"string","enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","RETRY_LATER"]},"machine_action":{"type":"string","enum":["USE_COMPANY","PRESENT_CANDIDATES","REQUEST_IDENTIFIER","REQUEST_IDENTITY_EVIDENCE","HOLD","BLOCK","RETRY_LATER"]},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"risk_level":{"anyOf":[{"type":"string","enum":["LOW","MEDIUM","HIGH","CRITICAL"]},{"type":"null"}]},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","required_before_action"],"properties":{"code":{"type":"string"},"required_before_action":{"type":"boolean"}}}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"company":{"type":"object","additionalProperties":false,"required":["entity_id","legal_name","jurisdiction","identifier","resolution_status","legal_status"],"properties":{"entity_id":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"identifier":{"type":"object","additionalProperties":false,"required":["scheme","value","evidence_reference"],"properties":{"scheme":{"type":"string"},"value":{"type":"string"},"evidence_reference":{"type":"string"}}},"resolution_status":{"type":"string","enum":["MATCH","AMBIGUOUS"]},"legal_status":{"const":"UNKNOWN"}}},"ambiguity":{"type":"object","additionalProperties":false,"required":["status","candidate_count","candidates"],"properties":{"status":{"type":"string","enum":["UNAMBIGUOUS","AMBIGUOUS"]},"candidate_count":{"type":"integer","minimum":0},"candidates":{"type":"array","items":{"type":"string"}}}},"checks_executed":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["check_id","capability","scope"],"properties":{"check_id":{"type":"string"},"capability":{"type":"string"},"scope":{"type":"string"}}}},"checks_reused":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["check_id","capability","scope"],"properties":{"check_id":{"type":"string"},"capability":{"type":"string"},"scope":{"type":"string"}}}},"coverage":{"type":"object","additionalProperties":false,"required":["scope","supported","state_legal_status","limitations"],"properties":{"scope":{"const":"FEDERAL_ONLY"},"supported":{"type":"boolean"},"state_legal_status":{"const":"NOT_ASSERTED"},"limitations":{"type":"array","items":{"type":"string"}}}},"source_health":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source_id","status","artifact_digest","valid_as_of","valid_until"],"properties":{"source_id":{"type":"string"},"status":{"type":"string"},"artifact_digest":{"anyOf":[{"type":"string"},{"type":"null"}]},"valid_as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"evidence_ids":{"type":"array","items":{"type":"string"}},"freshness":{"type":"object","additionalProperties":false,"required":["status","valid_as_of","valid_until"],"properties":{"status":{"const":"CURRENT"},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"}}},"limitations":{"type":"array","items":{"type":"string"}},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"authorization_token":{"type":"null"},"charged":{"type":"boolean"},"billing":{"type":"object","additionalProperties":false,"required":["mode","primitive_billing","charge_reference"],"properties":{"mode":{"const":"COMPOSITE_SINGLE_CHARGE"},"primitive_billing":{"const":"DISABLED"},"charge_reference":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"delivery":{"type":"object","additionalProperties":false,"required":["status","result_digest"],"properties":{"status":{"const":"DELIVERED"},"result_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}}}},"CompanyCheckError":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","candidates","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.check.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"charged":{"const":false},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"SupplierApprovalRequest":{"type":"object","additionalProperties":false,"properties":{"supplier":{"type":"object","additionalProperties":false,"properties":{"caller_supplier_reference":{"type":"string","minLength":1,"maxLength":120},"entity_id":{"type":"string","minLength":1,"maxLength":120},"identifier":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI","EIN"]},"value":{"type":"string","minLength":1,"maxLength":80},"fingerprint":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"reference":{"type":"string","minLength":1,"maxLength":120},"jurisdiction":{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"}},"required":["type"]},"legal_name":{"type":"string","minLength":1,"maxLength":200},"jurisdiction":{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"},"product_or_service":{"type":"string","minLength":1,"maxLength":300},"sector":{"type":"string","minLength":1,"maxLength":100},"relationship":{"const":"NEW_SUPPLIER"},"spend_band":{"type":"string","enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]}},"required":["caller_supplier_reference","legal_name","jurisdiction","relationship","spend_band"]},"payee":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider":{"type":"string","minLength":1,"maxLength":80},"merchant_url":{"type":"string","minLength":1,"maxLength":500,"format":"uri","pattern":"^https://"},"fingerprint":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}},"required":["type","value"]},"documents":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"document_id":{"type":"string","minLength":1,"maxLength":120},"document_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"type":{"type":"string","minLength":1,"maxLength":80}},"required":["document_id","document_digest","type"]},"maxItems":30},"policy":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","enum":["US_LEGAL_EXISTENCE_V1","US_COMPANY_CHECK_V1","US_INVOICE_MATCH_V1","US_PAYEE_BINDING_V1","US_INVOICE_PAYEE_VERIFICATION_V1","US_NEW_SUPPLIER_V1","US_FEDERAL_COUNTERPARTY_V1","US_VENDOR_PAYMENT_DETAIL_CHANGE_V1","US_LOW_VALUE_PAYMENT_V1","US_EXISTING_SUPPLIER_PAYMENT_V1","US_HIGH_VALUE_PAYMENT_V1","US_NEW_SUPPLIER_PAYMENT_V1","US_PAYMENT_AUTHORIZATION_V1"]},"version":{"const":"1.0.0"}},"required":["id","version"]}},"required":["supplier"]},"SupplierApprovalQuote":{"type":"object","additionalProperties":false,"required":["quote_id","quote_digest","product","product_version","policy","price","price_version","checks_planned","checks_reused","coverage","sellability","source_health_digest","manifest_digest","request_digest","idempotency_digest","expires_at"],"properties":{"quote_id":{"type":"string","pattern":"^quote_[A-Za-z0-9_-]+$"},"quote_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"product":{"const":"us.supplier.approve.v1"},"product_version":{"const":"1.0.0"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"enum":["US_NEW_SUPPLIER_V1","US_FEDERAL_COUNTERPARTY_V1"]},"version":{"const":"1.0.0"}}},"price":{"type":"object","additionalProperties":false,"required":["amount","amount_atomic","asset","network"],"properties":{"amount":{"const":"0.20"},"amount_atomic":{"const":"200000"},"asset":{"const":"USDC"},"network":{"const":"eip155:8453"}}},"price_version":{"const":"1.0.0"},"checks_planned":{"type":"array","items":{"type":"string"},"maxItems":100},"checks_reused":{"type":"array","items":{"type":"string"},"maxItems":100},"coverage":{"type":"object","additionalProperties":true},"sellability":{"const":"SELLABLE"},"source_health_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"manifest_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"idempotency_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"expires_at":{"type":"string","format":"date-time"}}},"SupplierApprovalResponse":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","minLength":1,"maxLength":120,"pattern":"^req_[A-Za-z0-9_-]+$"},"request_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"idempotency_reference":{"type":"string","minLength":1,"maxLength":120,"pattern":"^idem_[A-Za-z0-9_-]+$"},"policy":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","enum":["US_LEGAL_EXISTENCE_V1","US_COMPANY_CHECK_V1","US_INVOICE_MATCH_V1","US_PAYEE_BINDING_V1","US_INVOICE_PAYEE_VERIFICATION_V1","US_NEW_SUPPLIER_V1","US_FEDERAL_COUNTERPARTY_V1","US_VENDOR_PAYMENT_DETAIL_CHANGE_V1","US_LOW_VALUE_PAYMENT_V1","US_EXISTING_SUPPLIER_PAYMENT_V1","US_HIGH_VALUE_PAYMENT_V1","US_NEW_SUPPLIER_PAYMENT_V1","US_PAYMENT_AUTHORIZATION_V1"]},"version":{"const":"1.0.0"}},"required":["id","version"]},"decision":{"type":"string","enum":["APPROVE","APPROVE_WITH_CONDITIONS","HOLD","REVIEW","REJECT","INSUFFICIENT_EVIDENCE"]},"authorization":{"type":"string","enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","RETRY_LATER"]},"machine_action":{"type":"string","enum":["USE_ENTITY","PRESENT_CANDIDATES","REQUEST_JURISDICTION","REQUEST_IDENTIFIER","STOP","CONTINUE_ONBOARDING","REQUEST_CERTIFICATE","CONTINUE_TO_PAYMENT_PREFLIGHT","REQUEST_CORRECTED_INVOICE","HOLD_INVOICE","BLOCK_INVOICE","USE_PAYEE","REQUEST_PAYEE_PROOF","REQUEST_INDEPENDENT_CONFIRMATION","ENABLE_VENDOR","ENABLE_WITH_LIMITS","REQUEST_INFORMATION","REQUEST_DOCUMENT","HOLD_ONBOARDING","REJECT_VENDOR","UPDATE_VENDOR_PAYEE","HOLD_VENDOR_CHANGE","BLOCK_VENDOR_CHANGE","RELEASE_PAYMENT","HOLD_PAYMENT","BLOCK_PAYMENT","RETRY_LATER"]},"confidence":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"confidence_components":{"type":"object","additionalProperties":false,"properties":{"identity":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true},"evidence":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"freshness":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"policy_completeness":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001},"extraction":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true},"payee_binding":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true},"invoice_match":{"type":"number","minimum":0,"maximum":1,"multipleOf":0.0001,"nullable":true}},"required":["identity","evidence","freshness","policy_completeness"]},"risk_level":{"type":"string","enum":["LOW","MEDIUM","HIGH","CRITICAL","UNKNOWN"]},"risk_scope":{"type":"string","enum":["SUPPORTED_POLICY_SCOPE","IDENTITY_ONLY","REGISTRATION_ONLY","INVOICE_MATCH_ONLY","PAYEE_BINDING_ONLY","PARTIAL_COVERAGE","NOT_ASSESSED"]},"reason_codes":{"type":"array","items":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_JURISDICTION","COVERAGE_UNAVAILABLE","ENTITY_AMBIGUOUS","ENTITY_NOT_FOUND","ENTITY_CONFLICT","SOURCE_UNAVAILABLE","SOURCE_STALE","SOURCE_SCHEMA_INCOMPATIBLE","SOURCE_AUTHENTICATION_FAILED","PARTIAL_COVERAGE","POLICY_INPUT_MISSING","MANDATORY_CHECK_INCOMPLETE","IDEMPOTENCY_CONFLICT","QUOTE_EXPIRED","QUOTE_INVALIDATED","HEALTH_DIGEST_CHANGED","AUTHORIZATION_EXPIRED","AUTHORIZATION_REVOKED","AUTHORIZATION_SCOPE_MISMATCH","AUTHORIZATION_ALREADY_CONSUMED","REMEDIATION_REQUIRED","JURISDICTION_REQUIRED","IDENTIFIER_REQUIRED","LEGAL_STATUS_NOT_ACTIVE","REGISTRATION_NOT_FOUND","INVOICE_ENTITY_MISMATCH","INVOICE_TOTAL_REQUIRED","INVOICE_DATE_INVALID","PAYEE_UNRESOLVED","PAYEE_MISMATCH","PAYEE_PROOF_REQUIRED","INDEPENDENT_CONFIRMATION_REQUIRED","SUPPLIER_INFORMATION_MISSING","SUPPLIER_REJECTED","VENDOR_CHANGE_UNCONFIRMED","PAYMENT_OBLIGATION_MISMATCH"]},"maxItems":50},"conditions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","minLength":1,"maxLength":80},"description":{"type":"string","minLength":1,"maxLength":500},"required_before_action":{"type":"boolean"},"expires_at":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"evidence_requirements":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":20}},"required":["code","required_before_action","evidence_requirements"]},"maxItems":30},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","minLength":1,"maxLength":80},"reason_code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_JURISDICTION","COVERAGE_UNAVAILABLE","ENTITY_AMBIGUOUS","ENTITY_NOT_FOUND","ENTITY_CONFLICT","SOURCE_UNAVAILABLE","SOURCE_STALE","SOURCE_SCHEMA_INCOMPATIBLE","SOURCE_AUTHENTICATION_FAILED","PARTIAL_COVERAGE","POLICY_INPUT_MISSING","MANDATORY_CHECK_INCOMPLETE","IDEMPOTENCY_CONFLICT","QUOTE_EXPIRED","QUOTE_INVALIDATED","HEALTH_DIGEST_CHANGED","AUTHORIZATION_EXPIRED","AUTHORIZATION_REVOKED","AUTHORIZATION_SCOPE_MISMATCH","AUTHORIZATION_ALREADY_CONSUMED","REMEDIATION_REQUIRED","JURISDICTION_REQUIRED","IDENTIFIER_REQUIRED","LEGAL_STATUS_NOT_ACTIVE","REGISTRATION_NOT_FOUND","INVOICE_ENTITY_MISMATCH","INVOICE_TOTAL_REQUIRED","INVOICE_DATE_INVALID","PAYEE_UNRESOLVED","PAYEE_MISMATCH","PAYEE_PROOF_REQUIRED","INDEPENDENT_CONFIRMATION_REQUIRED","SUPPLIER_INFORMATION_MISSING","SUPPLIER_REJECTED","VENDOR_CHANGE_UNCONFIRMED","PAYMENT_OBLIGATION_MISMATCH"]},"field_path":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":500},"accepted_evidence_types":{"type":"array","items":{"type":"string","enum":["OFFICIAL_RECORD","CALLER_PROVIDED_DOCUMENT","MERCHANT_ASSERTION","SUPPLIER_ASSERTION","INDEPENDENT_CONFIRMATION","PROVIDER_ATTESTATION","SIGNED_WALLET_CHALLENGE"]},"maxItems":20}},"required":["type","reason_code","field_path","accepted_evidence_types"]},"maxItems":30},"checks_executed":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"check_id":{"type":"string","minLength":1,"maxLength":120},"check_version":{"type":"string","minLength":1,"maxLength":40},"status":{"type":"string","minLength":1,"maxLength":80},"source_version_set_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"result_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"valid_until":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"reused":{"type":"boolean"}},"required":["check_id","check_version","status","source_version_set_digest","result_digest","valid_until","reused"]},"maxItems":100},"checks_reused":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"check_id":{"type":"string","minLength":1,"maxLength":120},"check_version":{"type":"string","minLength":1,"maxLength":40},"status":{"type":"string","minLength":1,"maxLength":80},"source_version_set_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"result_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"valid_until":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"reused":{"type":"boolean"}},"required":["check_id","check_version","status","source_version_set_digest","result_digest","valid_until","reused"]},"maxItems":100},"coverage":{"type":"object","additionalProperties":false,"properties":{"supported":{"type":"boolean"},"country":{"const":"US"},"jurisdictions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"},"maxItems":56},"populations":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":50},"included_sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":120},"maxItems":50},"excluded_sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":120},"maxItems":50},"limitations":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"maxItems":50},"manifest_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"}},"required":["supported","country","jurisdictions","populations","included_sources","excluded_sources","limitations","manifest_digest"]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"source_id":{"type":"string","minLength":1,"maxLength":120},"status":{"type":"string","enum":["HEALTHY","DEGRADED","STALE","UNAVAILABLE","SCHEMA_BREAK","UNKNOWN"]},"source_version":{"type":"string","minLength":1,"maxLength":80},"health_digest":{"type":"string","minLength":1,"maxLength":80,"pattern":"^sha256:[a-f0-9]{64}$"},"source_updated_at":{"anyOf":[{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},{"type":"null"}]},"collected_at":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"valid_as_of":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"expires_at":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"}},"required":["source_id","status","source_version","health_digest","source_updated_at","collected_at","valid_as_of","expires_at"]},"maxItems":100},"evidence_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":120},"maxItems":100},"valid_as_of":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"valid_until":{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},"authorization_token":{"anyOf":[{"type":"string","minLength":1,"maxLength":8192},{"type":"null"}]},"remediation":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"remediation_id":{"type":"string","minLength":1,"maxLength":120},"status":{"type":"string","enum":["REQUIRED","IN_PROGRESS","COMPLETED"]}},"required":["remediation_id","status"]},{"type":"null"}]},"commerce":{"type":"object","additionalProperties":false,"properties":{"quote_id":{"type":"string","minLength":1,"maxLength":120},"amount":{"type":"string","minLength":1,"maxLength":30,"pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"asset":{"const":"USDC"},"network":{"const":"eip155:8453"},"charge_reference":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"settlement_reference":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]}},"required":["quote_id","amount","asset","network","charge_reference","settlement_reference"]},"subject":{"type":"object","additionalProperties":false,"properties":{"entity_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"country":{"const":"US"},"jurisdiction":{"anyOf":[{"type":"string","minLength":1,"maxLength":5,"pattern":"^US-(A[LKZR]|C[AOT]|D[CE]|F[LM]|G[AU]|HI|I[ADLN]|K[SY]|LA|M[ADEHINOST]|N[CDEHJMVY]|O[HKR]|P[AR]|RI|S[CD]|T[NX]|UT|V[AIT]|W[AIVY])$"},{"type":"null"}]}},"required":["entity_id","country","jurisdiction"]},"result":{"type":"object","additionalProperties":false,"properties":{"supplier_id":{"type":"string","minLength":1,"maxLength":120},"supplier_authorization_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"approval_limits":{"type":"object","additionalProperties":false,"properties":{"spend_band":{"type":"string","enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]},"valid_until":{"anyOf":[{"type":"string","minLength":1,"maxLength":35,"format":"date-time"},{"type":"null"}]},"conditions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":30}},"required":["spend_band","valid_until","conditions"]},"supplier_status":{"type":"string","enum":["APPROVED","APPROVED_WITH_CONDITIONS","ON_HOLD","REJECTED"]}},"required":["supplier_id","supplier_authorization_id","approval_limits","supplier_status"]}},"required":["schema_version","product","request_id","request_digest","idempotency_reference","policy","decision","authorization","machine_action","confidence","confidence_components","risk_level","risk_scope","reason_codes","conditions","required_information","checks_executed","checks_reused","coverage","source_health","evidence_ids","valid_as_of","valid_until","authorization_token","remediation","commerce","subject","result"]},"SupplierApprovalError":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","coverage","source_health","charged","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.supplier.approve.v1"},"request_id":{"type":"string","pattern":"^req_[A-Za-z0-9_-]+$"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"maxItems":100},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}},"maxItems":30},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true},"maxItems":100},"charged":{"type":"boolean"},"retry_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"SupplierApprovalTokenClaims":{"type":"object","additionalProperties":false,"required":["token_version","issuer","audience","key_id","subject_supplier_entity_id","product_id","product_version","policy_id","policy_version","authorization","approved_actions","conditions","limits","evidence_digest","decision_digest","request_digest","issued_at","not_before","valid_until","nonce","usage_limit","revocation_reference"],"properties":{"token_version":{"const":"CDO-AUTHORIZATION-TOKEN-V1"},"issuer":{"type":"string"},"audience":{"type":"string"},"key_id":{"type":"string"},"subject_supplier_entity_id":{"type":"string"},"product_id":{"const":"us.supplier.approve.v1"},"product_version":{"const":"1.0.0"},"policy_id":{"const":"US_FEDERAL_COUNTERPARTY_V1"},"policy_version":{"const":"1.0.0"},"authorization":{"type":"string"},"approved_actions":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"}},"limits":{"type":"object","additionalProperties":false,"required":["maximum_uses","valid_until"],"properties":{"maximum_uses":{"type":"integer","minimum":1},"valid_until":{"type":"string","format":"date-time"}}},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"issued_at":{"type":"integer"},"not_before":{"type":"integer"},"valid_until":{"type":"integer"},"nonce":{"type":"string"},"usage_limit":{"type":"integer","minimum":1},"revocation_reference":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"InvoicePayeeVerificationRequest":{"$id":"InvoicePayeeVerificationRequestV1","type":"object","additionalProperties":false,"required":["schema_version","policy_id","subject","invoice","payee","payment_context"],"properties":{"schema_version":{"const":"1.0.0"},"policy_id":{"const":"US_INVOICE_PAYEE_VERIFICATION_V1"},"subject":{"type":"object","additionalProperties":false,"required":["jurisdiction"],"anyOf":[{"required":["entity_id"]},{"required":["identifier"]}],"properties":{"entity_id":{"type":"string","minLength":1,"maxLength":160},"identifier":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI","EIN"]},"value":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"}}},"legal_name":{"type":"string","minLength":1,"maxLength":200},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"country":{"const":"US","default":"US"}}},"invoice":{"type":"object","additionalProperties":false,"required":["invoice_id","invoice_number","issue_date","currency","total_amount","supplier_legal_name"],"properties":{"invoice_id":{"type":"string","minLength":1,"maxLength":160},"invoice_number":{"type":"string","minLength":1,"maxLength":120},"issue_date":{"type":"string","format":"date"},"due_date":{"type":"string","format":"date"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"total_amount":{"type":"string","pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"supplier_legal_name":{"type":"string","minLength":1,"maxLength":200},"supplier_identifiers":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["STATE_ENTITY_NUMBER","UEI","CAGE","NPI","USDOT","MC","CIK","LEI","EIN"]},"value":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"}}},"default":[]},"billing_address":{"type":"object","additionalProperties":false,"required":["line1","locality","subdivision","postal_code","country"],"properties":{"line1":{"type":"string","minLength":1,"maxLength":200},"line2":{"type":"string","minLength":1,"maxLength":200},"locality":{"type":"string","minLength":1,"maxLength":120},"subdivision":{"type":"string","minLength":1,"maxLength":80},"postal_code":{"type":"string","minLength":1,"maxLength":24},"country":{"const":"US"}}},"remittance_information":{"type":"object","additionalProperties":false,"properties":{"legal_name":{"type":"string","minLength":1,"maxLength":200},"address":{"type":"object","additionalProperties":false,"required":["line1","locality","subdivision","postal_code","country"],"properties":{"line1":{"type":"string","minLength":1,"maxLength":200},"line2":{"type":"string","minLength":1,"maxLength":200},"locality":{"type":"string","minLength":1,"maxLength":120},"subdivision":{"type":"string","minLength":1,"maxLength":80},"postal_code":{"type":"string","minLength":1,"maxLength":24},"country":{"const":"US"}}},"opaque_reference":{"type":"string","minLength":1,"maxLength":160}}},"purchase_order":{"type":"string","minLength":1,"maxLength":160},"customer_identity":{"type":"object","additionalProperties":false,"required":["legal_name"],"properties":{"legal_name":{"type":"string","minLength":1,"maxLength":200},"identifier":{"type":"string","minLength":1,"maxLength":160}}},"document_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"metadata":{"type":"object","maxProperties":30,"additionalProperties":{"type":["string","number","boolean","null"],"maxLength":500}}}},"payee":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}}},"payee_evidence":{"type":"array","maxItems":30,"default":[],"items":{"type":"object","additionalProperties":false,"required":["assertion_id","type","claim_classification","evidence_digest"],"properties":{"assertion_id":{"type":"string","minLength":1,"maxLength":160},"type":{"enum":["OFFICIAL_RECORD","CALLER_PROVIDED_DOCUMENT","MERCHANT_ASSERTION","SUPPLIER_ASSERTION","INDEPENDENT_CONFIRMATION","PROVIDER_ATTESTATION","SIGNED_WALLET_CHALLENGE"]},"claim_classification":{"enum":["OBSERVED_FACT","NORMALIZED_FACT","INFERENCE","POLICY_OUTCOME"]},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"observed_at":{"type":"string","format":"date-time"}}}},"payee_challenge":{"type":"object","additionalProperties":false,"required":["method"],"properties":{"challenge_reference":{"type":"string","minLength":1,"maxLength":160},"challenge_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"method":{"enum":["PROVIDER_ATTESTATION","SIGNED_WALLET_CHALLENGE"]}}},"payment_context":{"type":"object","additionalProperties":false,"required":["amount_band"],"properties":{"amount_band":{"enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]},"destination_changed":{"type":"boolean","default":false},"duplicate_invoice_indicator":{"type":"boolean","default":false},"purchase_order_required":{"type":"boolean","default":false}}},"supplier_approval_token":{"type":"string","minLength":32,"maxLength":8192}}},"InvoicePayeeVerificationResponse":{"type":"object","additionalProperties":false,"required":["schema_version","product","product_version","request_id","request_digest","execution_id","policy","decision","machine_action","reason_codes","conditions","required_information","required_evidence","retry_after","checks_may_be_reused","invoice_match","payee_binding","supplier_approval","coverage","source_health","evidence_ids","evidence_bundle","quote","billing","delivery","replay","authorization_token","valid_as_of","valid_until"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"product_version":{"const":"1.0.0"},"request_id":{"type":"string"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"execution_id":{"type":"string"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"const":"US_INVOICE_PAYEE_VERIFICATION_V1"},"version":{"const":"1.0.0"}}},"decision":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","UNDETERMINED"]},"machine_action":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","required_before_action"],"properties":{"code":{"type":"string"},"required_before_action":{"type":"boolean"}}}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field_path","reason_code"],"properties":{"field_path":{"type":"string"},"reason_code":{"type":"string"}}}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"checks_may_be_reused":{"type":"boolean"},"invoice_match":{"type":["null","object"],"additionalProperties":true},"payee_binding":{"type":["null","object"],"additionalProperties":true},"supplier_approval":{"type":["null","object"],"additionalProperties":true},"coverage":{"type":"object","additionalProperties":true},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true}},"evidence_ids":{"type":"array","items":{"type":"string"}},"evidence_bundle":{"type":"object","additionalProperties":false,"required":["evidence_ids","decision_digest","limitations"],"properties":{"evidence_ids":{"type":"array","items":{"type":"string"}},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"limitations":{"type":"array","items":{"type":"string"}}}},"quote":{"type":"object","additionalProperties":true},"billing":{"type":"object","additionalProperties":true},"delivery":{"type":"object","additionalProperties":true},"replay":{"type":"object","additionalProperties":true},"authorization_token":{"type":"null"},"valid_as_of":{"type":["null","string"],"format":"date-time"},"valid_until":{"type":["null","string"],"format":"date-time"}}},"InvoicePayeeVerificationReplayResponse":{"type":"object","additionalProperties":false,"required":["schema_version","product","execution_id","replay_id","replay_digest","decision_digest","evidence_references","integrity_status","replay_state","sources_reexecuted","signer_invocations","additional_delivery","additional_charge","economic_mutations","redaction_preserved","metadata"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"execution_id":{"type":"string","pattern":"^orc_[0-9a-f]{32}$"},"replay_id":{"type":"string"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"evidence_references":{"type":"array","minItems":1,"items":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"integrity_status":{"const":"MATCH"},"replay_state":{"const":"PERSISTED"},"sources_reexecuted":{"const":false},"signer_invocations":{"const":0},"additional_delivery":{"const":false},"additional_charge":{"const":false},"economic_mutations":{"const":0},"redaction_preserved":{"const":true},"metadata":{"type":"object","additionalProperties":true}}},"InvoicePayeeVerificationError":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.invoice_payee.verify.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{"type":"object","additionalProperties":true}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"],"format":"date-time"},"charged":{"const":false}}},"PaymentAuthorizationRequest":{"$id":"PaymentAuthorizationRequestV1","type":"object","additionalProperties":false,"required":["schema_version","policy_id","payment_instruction","invoice_verification","supplier_approval_token","supplier","payee","amount","currency","payment_destination","jurisdiction","limits"],"properties":{"schema_version":{"const":"1.0.0"},"policy_id":{"const":"US_PAYMENT_AUTHORIZATION_V1"},"payment_instruction":{"type":"object","additionalProperties":false,"required":["instruction_id","instruction_digest"],"properties":{"instruction_id":{"type":"string","minLength":1,"maxLength":160},"instruction_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"purpose":{"type":"string","minLength":1,"maxLength":300}}},"invoice_verification":{"type":"object","additionalProperties":false,"required":["execution_id","decision_digest"],"properties":{"execution_id":{"type":"string","minLength":1,"maxLength":160},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"supplier_approval_token":{"type":"string","minLength":32,"maxLength":8192},"supplier":{"type":"object","additionalProperties":false,"required":["entity_id","jurisdiction"],"properties":{"entity_id":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"}}},"payee":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}}},"amount":{"type":"string","pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"payment_destination":{"type":"object","additionalProperties":false,"required":["type","value"],"properties":{"type":{"enum":["X402_PAYTO","WALLET","MERCHANT_RESOURCE","PAYOUT_DESTINATION_TOKEN","PROVIDER_ACCOUNT_TOKEN"]},"value":{"type":"string","minLength":1,"maxLength":512},"provider_namespace":{"type":"string","minLength":1,"maxLength":80}}},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"limits":{"type":"object","additionalProperties":false,"required":["amount_band"],"properties":{"amount_band":{"enum":["MICRO","LOW","MEDIUM","HIGH","VERY_HIGH"]},"limit_amount":{"type":"string","pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"destination_changed":{"type":"boolean","default":false},"approval_required":{"type":"boolean","default":false}}}}},"PaymentAuthorizationResponse":{"type":"object","additionalProperties":true,"required":["schema_version","product","product_version","request_id","request_digest","execution_id","policy","decision","machine_action","reason_codes","evidence_bundle","quote","billing","delivery","replay","payment_executed","authorization_token"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"product_version":{"const":"1.0.0"},"decision":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","BLOCK","UNDETERMINED"]},"machine_action":{"enum":["AUTHORIZE_PAYMENT","AUTHORIZE_WITH_LIMITS","HOLD_PAYMENT","REQUEST_ADDITIONAL_EVIDENCE","REQUEST_APPROVAL","BLOCK_PAYMENT","RETRY_LATER"]},"payment_executed":{"const":false},"authorization_token":{"type":"null"}}},"PaymentAuthorizationReplayResponse":{"type":"object","additionalProperties":false,"required":["schema_version","product","execution_id","replay_id","replay_digest","decision_digest","evidence_references","integrity_status","replay_state","sources_reexecuted","signer_invocations","additional_delivery","additional_charge","economic_mutations","redaction_preserved","payment_executed","metadata"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"execution_id":{"type":"string","pattern":"^orc_[0-9a-f]{32}$"},"replay_id":{"type":"string"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"evidence_references":{"type":"array","minItems":1,"items":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},"integrity_status":{"const":"MATCH"},"replay_state":{"const":"PERSISTED"},"sources_reexecuted":{"const":false},"signer_invocations":{"const":0},"additional_delivery":{"const":false},"additional_charge":{"const":false},"economic_mutations":{"const":0},"redaction_preserved":{"const":true},"payment_executed":{"const":false},"metadata":{"type":"object","additionalProperties":true}}},"PaymentAuthorizationError":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","error","reason_codes","required_information","required_evidence","retry_after","charged"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.payment.authorize.v1"},"request_id":{"type":"string"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"required_information":{"type":"array","items":{}},"required_evidence":{"type":"array","items":{"type":"string"}},"retry_after":{"type":["null","string"]},"charged":{"const":false}}},"CompanyCapabilityPassportCreate":{"$id":"CompanyCapabilityPassportCreateV1","type":"object","additionalProperties":false,"required":["schema_version","subject_entity_id","canonical_entity_identity","jurisdictions","decisions"],"properties":{"schema_version":{"const":"1.0.0"},"subject_entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"canonical_entity_identity":{"type":"object","additionalProperties":false,"required":["entity_id","display_name","registration_ref_digest"],"properties":{"entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"display_name":{"type":"string","minLength":1,"maxLength":200},"registration_ref_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"jurisdictions":{"type":"array","minItems":1,"maxItems":20,"uniqueItems":true,"items":{"type":"string","pattern":"^US-[A-Z]{2}$"}},"decisions":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["decision_ref","product_id","product_version","policy_id","policy_version","subject_entity_id","jurisdiction","issuer","audience","decision_digest","evidence_refs","coverage_status","source_health_status","revocation_status","valid_as_of","valid_until","capabilities","authorizations"],"properties":{"decision_ref":{"type":"string","pattern":"^dec_[A-Za-z0-9._:-]{6,150}$"},"product_id":{"enum":["us.company.check.v1","us.supplier.approve.v1","us.invoice_payee.verify.v1","us.payment.authorize.v1"]},"product_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"policy_id":{"type":"string","minLength":1,"maxLength":160},"policy_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"subject_entity_id":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"jurisdiction":{"type":"string","pattern":"^US-[A-Z]{2}$"},"issuer":{"type":"string","minLength":1,"maxLength":160},"audience":{"type":"string","minLength":1,"maxLength":160},"decision_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"evidence_refs":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["evidence_id","evidence_digest","classification","valid_as_of","valid_until","status"],"properties":{"evidence_id":{"type":"string","pattern":"^ev_[A-Za-z0-9._:-]{6,150}$"},"evidence_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"classification":{"enum":["SOURCE_OBSERVATION","NORMALIZED_FACT","INFERENCE","POLICY_RESULT","AUTHORIZATION_RESULT","LIMITATION"]},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"status":{"enum":["CURRENT","STALE","REVOKED","INVALID"]}}}},"coverage_status":{"enum":["SUFFICIENT","LIMITED","INSUFFICIENT","UNKNOWN"]},"source_health_status":{"enum":["HEALTHY","DEGRADED","UNAVAILABLE","UNKNOWN"]},"revocation_status":{"enum":["ACTIVE","REVOKED","INVALIDATED","SUPERSEDED"]},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"capabilities":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["capability_id","capability_version","status","scope","jurisdiction","confidence","risk_level"],"properties":{"capability_id":{"enum":["FEDERAL_COMPANY_GATE_EVALUATED","LEGAL_ENTITY_RESOLVED","LEGAL_STATUS_VERIFIED","SUPPLIER_APPROVED","INVOICE_COMPANY_MATCHED","PAYEE_BOUND","PAYMENT_ELIGIBLE","RIGHT_TO_TRANSACT","FRANCHISE_TAX_STATUS","RESTRICTED_PARTY_SCREENED","PAYMENT_DESTINATION_VERIFIED"]},"capability_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"status":{"enum":["VERIFIED","VERIFIED_WITH_CONDITIONS","SUPPORTED","CLAIMED","UNRESOLVED","NOT_AUTHORIZED","BLOCKED","STALE","REVOKED","UNDETERMINED"]},"scope":{"type":"string","minLength":1,"maxLength":160},"jurisdiction":{"type":"string","pattern":"^US(?:-[A-Z]{2})?$"},"confidence":{"type":"number","minimum":0,"maximum":1},"risk_level":{"enum":["LOW","MEDIUM","HIGH","CRITICAL","UNKNOWN"]},"conditions":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"limitations":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"critical":{"type":"boolean"}}}},"authorizations":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["authorization_id","authorization_type","status","scope","subject","resource","amount_limit","currency","destination_scope","valid_as_of","valid_until"],"properties":{"authorization_id":{"type":"string","minLength":1,"maxLength":160},"authorization_type":{"enum":["SUPPLIER_USE","INVOICE_ACCEPTANCE","PAYEE_USE","PAYMENT_ELIGIBILITY","PAYMENT_DESTINATION_USE"]},"status":{"enum":["AUTHORIZED","AUTHORIZED_WITH_LIMITS","HOLD","BLOCKED","EXPIRED","REVOKED","UNDETERMINED"]},"scope":{"type":"string","minLength":1,"maxLength":160},"subject":{"type":"string","pattern":"^(?:usent|ent)_[A-Za-z0-9._:-]{6,150}$"},"resource":{"type":["string","null"],"maxLength":160},"amount_limit":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]{0,17})(\\.[0-9]{1,6})?$"},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"destination_scope":{"type":["string","null"],"maxLength":160},"conditions":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"}}}},"risks":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}},"limitations":{"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":300}}}}}}},"CompanyCapabilityPassport":{"type":"object","required":["passport_id","passport_version","country","subject_entity_id","jurisdictions","status","capabilities","authorizations","evidence_refs","passport_digest","replay_ref","economic_mutations"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"country":{"const":"GB"},"subject_entity_id":{"type":"string","pattern":"^gbent_[A-Za-z0-9._:-]{6,150}$"},"jurisdictions":{"type":"array","contains":{"const":"GB"}},"status":{"type":"string"},"capabilities":{"type":"array"},"authorizations":{"type":"array"},"evidence_refs":{"type":"array"},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"replay_ref":{"type":"string"},"economic_mutations":{"const":0}}},"CompanyCapabilityPassportReplay":{"type":"object","additionalProperties":false,"required":["passport_id","passport_version","status","passport_digest","replay_digest","sources_queried","signer_invocations","versions_created","economic_mutations"],"properties":{"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"status":{"enum":["MATCH","MISMATCH"]},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"replay_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"sources_queried":{"const":0},"signer_invocations":{"const":0},"versions_created":{"const":0},"economic_mutations":{"const":0}}},"CompanyCapabilityPassportRefresh":{"type":"object","additionalProperties":false,"required":["schema_version","reason_code"],"properties":{"schema_version":{"const":"1.0.0"},"reason_code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{2,80}$"}}},"CompanyCapabilityPassportInvalidate":{"type":"object","additionalProperties":false,"required":["schema_version","reason_code","effective_at","source_ref"],"properties":{"schema_version":{"const":"1.0.0"},"reason_code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{2,80}$"},"authorization_id":{"type":"string","minLength":1,"maxLength":160},"effective_at":{"type":"string","format":"date-time"},"source_ref":{"type":"string","minLength":8,"maxLength":160}}},"CompanyCapabilityPassportError":{"type":"object","additionalProperties":false,"required":["schema_version","product","error","reason_codes","charged","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.company.capability.passport.v1"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"}},"charged":{"const":false},"economic_mutations":{"const":0}}},"DelawareLicenseRequest":{"type":"object","additionalProperties":false,"required":["lookup","policy_id","idempotency_key"],"properties":{"lookup":{"type":"object","additionalProperties":false,"minProperties":1,"maxProperties":1,"properties":{"legal_name":{"type":"string","minLength":2,"maxLength":300},"license_number":{"type":"string","pattern":"^[0-9]{1,32}$"}}},"policy_id":{"const":"US_DE_BUSINESS_LICENSE_VERIFICATION_V1"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}},"DelawareLicenseResponse":{"type":"object","additionalProperties":false,"required":["schema_version","contract_version","product","solution","request_id","quote_id","request_digest","jurisdiction","capability","policy","decision","authorization","machine_action","confidence","risk_level","reason_codes","recommended_action","coverage","license","source","evidence_ids","replay","sellability","billing"],"properties":{"schema_version":{"const":"1.0.0"},"contract_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"solution":{"const":"DELAWARE_BUSINESS_LICENSE_VERIFICATION"},"request_id":{"type":"string"},"quote_id":{"type":"string"},"request_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"jurisdiction":{"const":"US-DE"},"capability":{"const":"DELAWARE_BUSINESS_LICENSE"},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"const":"US_DE_BUSINESS_LICENSE_VERIFICATION_V1"},"version":{"const":"1.0.0"}}},"decision":{"type":"string","enum":["LICENSE_CURRENT","LICENSE_EXPIRED","LICENSE_FUTURE"]},"authorization":{"type":"string","enum":["ALLOW_LIMITED","HOLD"]},"machine_action":{"type":"string","enum":["USE_LICENSE_EVIDENCE_WITH_LIMITATIONS","HOLD"]},"confidence":{"type":"number","minimum":0,"maximum":1},"risk_level":{"type":"string","enum":["LOW","MEDIUM"]},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"recommended_action":{"type":"string"},"coverage":{"type":"object","additionalProperties":false,"required":["business_license","corporate_registry_status","limitations"],"properties":{"business_license":{"const":"LIMITED_AVAILABLE"},"corporate_registry_status":{"const":"UNSUPPORTED"},"limitations":{"type":"array","items":{"type":"string"},"minItems":1}}},"license":{"type":"object","additionalProperties":false,"required":["business_name","trade_name","category","license_number_digest","valid_from","valid_to","status"],"properties":{"business_name":{"type":"string"},"trade_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"license_number_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"valid_from":{"type":"string","format":"date-time"},"valid_to":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["CURRENT","EXPIRED","NOT_YET_VALID"]}}},"source":{"type":"object","additionalProperties":false,"required":["source_id","authority","dataset_id","dataset_title","attribution","metadata_license","freshness","source_updated_at","schema_version","parser_version"],"properties":{"source_id":{"const":"US_DE_DOF_BUSINESS_LICENSES"},"authority":{"const":"Delaware Department of Finance, Division of Revenue"},"dataset_id":{"const":"5zy2-grhr"},"dataset_title":{"const":"Delaware Business Licenses"},"attribution":{"const":"Delaware Department of Finance, Division of Revenue"},"metadata_license":{"const":"Public Domain"},"freshness":{"const":"CURRENT"},"source_updated_at":{"type":"string","format":"date-time"},"schema_version":{"const":"de_business_license_5zy2_grhr_schema_v1"},"parser_version":{"const":"de_business_license_directed_parser_v1"}}},"evidence_ids":{"type":"array","items":{"type":"string"},"minItems":1},"replay":{"type":"object","additionalProperties":false,"required":["reference","integrity"],"properties":{"reference":{"type":"string"},"integrity":{"const":"MATCH"}}},"sellability":{"const":"SELLABLE_WITH_LIMITATIONS"},"billing":{"type":"object","additionalProperties":false,"required":["price","network","asset","charge_reference","payment_authorization"],"properties":{"price":{"const":"0.03"},"network":{"const":"eip155:8453"},"asset":{"const":"USDC"},"charge_reference":{"type":"string"},"payment_authorization":{"const":"HOLD"}}}}},"DelawareLicenseError":{"type":"object","additionalProperties":false,"required":["schema_version","product","request_id","decision","error","reason_codes","charged","corporate_registry_status","payment_authorization","retry_after"],"properties":{"schema_version":{"const":"1.0.0"},"product":{"const":"us.de.business_license.verify.v1"},"request_id":{"type":"string"},"decision":{"const":"INSUFFICIENT_EVIDENCE"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"reason_codes":{"type":"array","items":{"type":"string"},"minItems":1},"charged":{"const":false},"corporate_registry_status":{"const":"UNSUPPORTED"},"payment_authorization":{"const":"HOLD"},"retry_after":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"UpdateUkCompanyCapabilityPassportRequest":{"type":"object","additionalProperties":false,"required":["schema_version","country","company_number","execution_ids","idempotency_key","reason_code"],"properties":{"schema_version":{"const":"1.0.0"},"country":{"const":"GB"},"company_number":{"type":"string","pattern":"^(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}$|^[0-9]{8}$"},"execution_ids":{"type":"array","minItems":1,"maxItems":50,"uniqueItems":true,"items":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"},"reason_code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{2,80}$"}}},"UkCompanyCapabilityPassportVerification":{"type":"object","additionalProperties":false,"required":["schema_version","country","jurisdiction","passport_id","passport_version","passport_digest","verification_state","replay_status","reason_codes","verified_at","valid_as_of","valid_until","coverage_status","source_health_status","policy_bindings","capabilities","limitations","conditions","sources_queried","versions_created","economic_mutations"],"properties":{"schema_version":{"const":"1.0.0"},"country":{"const":"GB"},"jurisdiction":{"const":"UNITED_KINGDOM"},"passport_id":{"type":"string","pattern":"^ccp_[0-9a-f]{32}$"},"passport_version":{"type":"integer","minimum":1},"passport_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"verification_state":{"enum":["VALID","VALID_WITH_LIMITATIONS","EXPIRED","REVOKED","UNDETERMINED"]},"replay_status":{"enum":["MATCH","MISMATCH"]},"reason_codes":{"type":"array","uniqueItems":true,"items":{"type":"string"}},"verified_at":{"type":"string","format":"date-time"},"valid_as_of":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"coverage_status":{"enum":["SUFFICIENT","LIMITED","INSUFFICIENT","UNKNOWN"]},"source_health_status":{"enum":["HEALTHY","DEGRADED","UNAVAILABLE","UNKNOWN"]},"policy_bindings":{"type":"array"},"capabilities":{"type":"array"},"limitations":{"type":"array"},"conditions":{"type":"array"},"sources_queried":{"const":0},"versions_created":{"const":0},"economic_mutations":{"const":0}}},"CreateUkCompanyCapabilityPassportRequest":{"type":"object","additionalProperties":false,"required":["schema_version","country","company_number","execution_ids","idempotency_key"],"properties":{"schema_version":{"const":"1.0.0"},"country":{"const":"GB"},"company_number":{"type":"string","pattern":"^(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}$|^[0-9]{8}$"},"execution_ids":{"type":"array","minItems":1,"maxItems":50,"uniqueItems":true,"items":{"type":"string","pattern":"^gbexec_[A-Za-z0-9]+$"}},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$"}}},"RestrictedBusinessPartyRequest":{"type":"object","additionalProperties":false,"required":["country","jurisdiction","subject"],"properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$"},"jurisdiction":{"type":"string"},"company_number":{"type":"string"},"subject":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":300},"aliases":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":300}},"identifiers":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":200}},"entity_type":{"enum":["PERSON","ENTITY","VESSEL","AIRCRAFT","OTHER"]}}},"idempotency_key":{"type":"string","maxLength":200}}},"ContinueVendorAuthorizationRequest":{"type":"object","additionalProperties":false,"required":["country","jurisdiction","entity","prior_authorization","policy","idempotency_key"],"properties":{"country":{"const":"GB"},"jurisdiction":{"const":"UNITED_KINGDOM"},"entity":{"type":"object","additionalProperties":false,"required":["company_number"],"properties":{"company_number":{"type":"string"},"identifiers":{"type":"array","items":{"type":"string"}}}},"prior_authorization":{"type":"object","additionalProperties":false,"required":["execution_id"],"properties":{"execution_id":{"type":"string","pattern":"^gbexec_[a-zA-Z0-9]+$"}}},"policy":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"const":"GB_CONTINUE_VENDOR_AUTHORIZATION_V1"},"version":{"const":"1.0.0"}}},"required_coverage":{"type":"array","uniqueItems":true,"items":{"enum":["COMPANY_IDENTITY","LEGAL_STATUS","RESTRICTED_PARTY"]}},"observed_changes":{"type":"array","items":{"type":"object"}},"passport_ref":{"type":"object"},"as_of":{"type":"string","format":"date-time"},"idempotency_key":{"type":"string","minLength":6,"maxLength":200}}},"UkDecisionEnvelope":{"type":"object","required":["schema_version","product_or_solution","decision","authorization","machine_action","policy","coverage","source_health","evidence","economic_activity","result"],"properties":{"schema_version":{"const":"1.0.0"},"product_or_solution":{"type":"string"},"decision":{"enum":["APPROVE","CONDITIONAL","REVIEW","BLOCK","RETRY","NO_DECISION"]},"authorization":{"enum":["ALLOW","ALLOW_WITH_CONDITIONS","HOLD","DENY"]},"machine_action":{"type":"string"},"policy":{"type":"object","required":["id","version","checksum"],"properties":{"id":{"type":"string","pattern":"^GB_"},"version":{"const":"1.0.0"},"checksum":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},"coverage":{"type":"object"},"source_health":{"type":"object"},"evidence":{"type":"array"},"economic_activity":{"type":"object","properties":{"charged":{"type":"boolean"},"quote_created":{"type":"boolean"},"settlement_created":{"type":"boolean"}}},"payment":{"type":"object"},"result":{}}}},"securitySchemes":{"UkPassportOperatorToken":{"type":"apiKey","in":"header","name":"x-admin-token"},"UkPassportOperatorBasic":{"type":"http","scheme":"basic"}}},"x-company-check":{"product":"us.company.check.v1","price":{"amount":"0.04","amount_atomic":"40000","asset":"USDC","network":"eip155:8453","version":"1.0.0"},"bazaarPublished":true},"x-supplier-approval":{"product":"us.supplier.approve.v1","price":{"amount":"0.20","amount_atomic":"200000","asset":"USDC","network":"eip155:8453"},"economicActivation":"CONTROLLED_PURCHASE_REQUIRED"},"x-invoice-payee-verification":{"product":"us.invoice_payee.verify.v1","economicActivation":"RUNTIME_GATED","bazaarPublished":"RUNTIME_GATED"},"x-payment-authorization":{"product":"us.payment.authorize.v1","economicActivation":"RUNTIME_GATED","bazaarPublished":"RUNTIME_GATED"},"x-company-capability-passport":{"product":"us.company.capability.passport.v1","mode":"RUNTIME_GATED","x402":"RUNTIME_GATED","bazaar":"RUNTIME_GATED","price":"0.30 USDC","scheduler":false,"noDecisionNoCharge":true},"x-delaware-business-license":{"product":"us.de.business_license.verify.v1","price":{"amount":"0.03","amount_atomic":"30000","asset":"USDC","network":"eip155:8453","version":"1.0.0"},"coverage":"DELAWARE_BUSINESS_LICENSE_ONLY","corporate_registry_status":"UNSUPPORTED","payment_authorization":"HOLD"},"x-uk-portfolio":{"country":"GB","jurisdiction":"UNITED_KINGDOM","technical":true,"economic":true,"x402":true,"bazaar":true,"discoverable":true,"officialAccess":"CERTIFIED_HEALTHY"}}