{"endpoint":"/v1/verify-facts","check_mode":"deterministic","description":"For claims that are lookups, not judgments. No LLM in the trust chain. Returns the same JWS envelope as /evaluate, verifiable offline with the same published JWKS.","request":{"shape":"{ subject: { claim_hash }, agent_id?, checks: [ { check_type, input } ] } (1 to 20 checks)","claim_hash":"subject.claim_hash is required: a request without it gets HTTP 400 with error missing_subject_claim_hash. For subject.claim_hash, the service checks only that it is present: it does not check the format or recompute it from the checks. We recommend sha256- followed by the lowercase SHA-256 hex digest of the RFC 8785 canonical JSON of the check's input object, or of the whole checks array when a request carries more than one check."},"supported_check_types":["signature_verification","hash_comparison","registry_lookup","regex_match","timestamp_validation","json_schema_conformance","contract_price_match","spend_cap"],"supported_registries":["pypi","npm","ietf_datatracker","github_repo"],"deterministic_mapping_id":"tanilo-deterministic-v0.3-2026-10-10","deterministic_catalog_revisions":[{"id":"tanilo-deterministic-v0.3-2026-10-10","status":"current","check_types":["signature_verification","hash_comparison","registry_lookup","regex_match","timestamp_validation","json_schema_conformance","contract_price_match","spend_cap"],"note":"The seven check types of v0.2, unchanged, plus spend_cap."},{"id":"tanilo-deterministic-v0.2-2026-10-04","status":"historical","check_types":["signature_verification","hash_comparison","registry_lookup","regex_match","timestamp_validation","json_schema_conformance","contract_price_match"],"note":"The six original check types, unchanged, plus contract_price_match. Receipts signed between 2026-10-04 and the current revision carry this id."},{"id":"agentoracle-deterministic-v0.1-2026-08-06","status":"historical","check_types":["signature_verification","hash_comparison","registry_lookup","regex_match","timestamp_validation","json_schema_conformance"],"note":"The six original check types. Receipts signed before 2026-10-04, and the published v0.1 conformance vectors, carry this id."}],"contract_price_match":{"rule_id":"contract-price-match/v0.1","question":"Does the unit price in an offer match the price in the applicable term, among the terms the caller supplied?","input":"{ offer: { unit_price, currency, unit, quantity, seller, sku, offered_at }, terms: [ { agreement_id, version, seller, product_scope: { skus }, currency, unit, price_per_unit | tiers, effective_from, effective_to?, supersedes? } ] }","states":["verified","contradicted","indeterminate"],"reasons":{"price_mismatch":"the offer's unit price differs from the applicable term's price","no_applicable_term":"no supplied term covers this seller and product","effective_interval_unresolved":"no supplied term for this seller and product is in effect at the offer time","precedence_unresolved":"more than one supplied term applies and no declared precedence settles which","currency_mismatch":"the applicable term is priced in a different currency; no conversion is made","unit_mismatch":"the applicable term is priced in a different unit; no conversion is made","tier_selection_unresolved":"the quantity falls in no tier, or in more than one tier, of the applicable term"},"gate":"verified -> act; contradicted -> halt; indeterminate -> halt. An indeterminate result is not a finding that the price is wrong, and is recorded as indeterminate, never as pass or fail.","signing":"A result is returned as a signed receipt when signing succeeds. If the service holds no signing key, it answers 503 with status not_signed and the check results, and nothing is signed.","rule_order":["scope","effective_at_offer_time","declared_precedence","exactly_one_term","currency","unit","price_or_tier","compare"],"limits":{"max_terms":200,"max_tiers_per_term":50,"max_skus_per_term":500,"max_string_length":200,"max_integer_digits":18,"max_fraction_digits":8},"docs":"https://tanilo.io/docs/contract-price-check","example_input":{"offer":{"unit_price":"2.00","currency":"USD","unit":"call","quantity":"1","seller":"seller.example","sku":"api.weather.v1","offered_at":"2026-10-01T12:00:00Z"},"terms":[{"agreement_id":"MSA-2026-014","version":"1","seller":"seller.example","product_scope":{"skus":["api.weather.v1"]},"currency":"USD","unit":"call","price_per_unit":"1.00","effective_from":"2026-01-01T00:00:00Z"}]},"does_not_establish":"The terms are supplied by the caller. This check does not establish that they are genuine, complete, validly executed or approved. It makes no unit or currency conversion, applies no rounding or tolerance, and calculates no tax. A verified result does not authorize a payment."},"spend_cap":{"rule_id":"spend-cap/v0.1","question":"Does the total of an offer (unit price times quantity, exact decimals) fit within the remaining cap the caller supplied?","input":"{ offer: { unit_price, currency, quantity?, offered_at?, seller?, sku? }, cap: { cap_id?, amount, currency, scope: per_purchase | per_period, already_spent?, period?: { from, to } } }","states":["verified","contradicted","indeterminate"],"reasons":{"cap_exceeded":"the offer's total exceeds the remaining cap","currency_mismatch":"the cap is in a different currency from the offer; no conversion is made","quantity_missing":"the offer carries no quantity, so no total can be computed","period_bounds_missing":"the cap is per period but carries no period bounds","offer_time_missing":"the cap is per period but the offer carries no offered_at, so it cannot be placed in the period","offer_outside_period":"the offer time falls outside the cap's period"},"gate":"verified -> act; contradicted -> halt; indeterminate -> halt. An indeterminate result is not a finding that the offer exceeds the cap, and is recorded as indeterminate, never as pass or fail.","signing":"A result is returned as a signed receipt when signing succeeds. If the service holds no signing key, it answers 503 with status not_signed and the check results, and nothing is signed.","rule_order":["currency","quantity","total","remaining_cap","compare"],"limits":{"max_string_length":200,"max_integer_digits":18,"max_fraction_digits":8},"docs":"https://tanilo.io/docs/spend-cap-check","example_input":{"offer":{"unit_price":"12.50","currency":"USD","quantity":"3","offered_at":"2026-10-10T12:00:00Z","seller":"seller.example","sku":"api.weather.v1"},"cap":{"cap_id":"api-budget-2026-10","amount":"100.00","currency":"USD","scope":"per_period","already_spent":"70.00","period":{"from":"2026-10-01T00:00:00Z","to":"2026-11-01T00:00:00Z"}}},"does_not_establish":"The cap and already_spent are caller-supplied. This check does not establish that the cap is authentic, approved or applicable to this purchase, or that already_spent is complete or current. It does not authenticate the supplied offer time or establish that the offer is still current. It does not retrieve budget balances, maintain a running balance or reserve funds: it keeps no state between calls and does not record this offer against the cap. It makes no currency conversion, applies no rounding or tolerance, and calculates no tax. It does not judge whether the purchase is sensible. A verified result does not authorize a payment."},"rejection":{"status":422,"error":"claim_not_deterministic","note":"No LLM fallback. Move to POST /evaluate for judgment, as an explicit choice by the caller."},"mapping":{"current":{"mapping_id":"tanilo-v0.3-2026-10-13","mapping_hash":"sha256-52842536d5c8444b6add8e8cb7e8987aa3fcc0bf40cc7ac266ddc1744f0711ce","published":"2026-10-13","url":"https://api.tanilo.io/mappings/52842536d5c8444b6add8e8cb7e8987aa3fcc0bf40cc7ac266ddc1744f0711ce.json","alias":"https://api.tanilo.io/mappings/tanilo-v0.3-2026-10-13.json"},"historical":[{"mapping_id":"agentoracle-v0.3-2026-05-30","mapping_hash":"sha256-0a78263976790df6e76cd9f3f441bf5a3b5c3a82e346b5aca43e49626881d7b0","published":"2026-05-30","url":"https://api.tanilo.io/mappings/0a78263976790df6e76cd9f3f441bf5a3b5c3a82e346b5aca43e49626881d7b0.json","alias":"https://api.tanilo.io/mappings/agentoracle-v0.3-2026-05-30.json","note":"Receipts signed before the cutover on 13 October 2026 (UTC) carry this id and hash; they are byte for byte unchanged and keep verifying. Rely on mapping_id and mapping_hash rather than the signing date to tell receipts apart."}],"cutover_at":"2026-10-13T00:07:22.431Z","cutover_at_note":"The first instant at which the deployment that serves tanilo-v0.3-2026-10-13 was observed answering on api.tanilo.io, polled once a second; the previous deployment's last observed answer was at 2026-10-13T00:07:21.433Z. The planned start was 2026-10-13T00:00:00Z, Monday 12 October 17:00 Pacific; this value was corrected to the observed instant on 2026-10-13. Receipts are told apart by mapping_id and mapping_hash, not by signing date.","same_rules":"The two documents differ only in mapping_id, issuer, resolution and published; recommendation_rules, gate_map and threshold are identical."},"anonymous_agent_id":{"current":"urn:tanilo:verify-facts:anonymous","historical":"did:ao:verify-facts:anonymous","cutover_at":"2026-10-13T00:07:22.431Z"},"kid":"tanilo-2026-10-ed25519-7d885da9","jwks_url":"https://tanilo.io/.well-known/jwks.json"}