{"id":"evidence-scope-mismatch","title":"Check that evidence covers the scope of the claim it is used for (geography, population, period, version, basis, unit)","description":"Compares the scope descriptors of a claim and of the evidence offered for it, per dimension: geography and population (every claimed item must be equal to, or contained in a broader evidence item according to the caller's taxonomy), period (the evidence period must contain the claimed period; partial or no overlap is a mismatch), and version, basis and unit (must be equal after normalization). Descriptors are supplied by the caller; this check does not read text to find them, and without a taxonomy two different place or group names are unknown, never assumed related. A dimension the claim does not declare is not checked.","roi":"Catches 'a 2019 US survey cited for a 2025 global claim' before it is published. One claim and one evidence scope per $0.005 call.","audience":"agent-infra","package":"context-evidence-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/evidence-scope-mismatch","path":"/api/v1/evidence-scope-mismatch","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["claim","evidence"],"properties":{"claim":{"type":"object","additionalProperties":false,"properties":{"geography":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Places the statement covers (countries, regions, 'worldwide')."},"population":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Who/what is covered (adults, EU residents, Series A startups)."},"period":{"type":"object","additionalProperties":false,"properties":{"start":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD."},"end":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD, inclusive."}},"required":["start","end"]},"version":{"type":"string","maxLength":60,"description":"Software, standard or edition version."},"basis":{"type":"string","maxLength":100,"description":"Measurement basis: per capita, nominal, mean, gross, as-reported..."},"unit":{"type":"string","maxLength":60,"description":"Unit of measure."}},"description":"Scope of the claim being made."},"evidence":{"type":"object","additionalProperties":false,"properties":{"geography":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Places the statement covers (countries, regions, 'worldwide')."},"population":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Who/what is covered (adults, EU residents, Series A startups)."},"period":{"type":"object","additionalProperties":false,"properties":{"start":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD."},"end":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD, inclusive."}},"required":["start","end"]},"version":{"type":"string","maxLength":60,"description":"Software, standard or edition version."},"basis":{"type":"string","maxLength":100,"description":"Measurement basis: per capita, nominal, mean, gross, as-reported..."},"unit":{"type":"string","maxLength":60,"description":"Unit of measure."}},"description":"Scope of the evidence offered."},"taxonomy":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"broader":{"type":"string","maxLength":100,"minLength":1},"narrower":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":200}},"required":["broader","narrower"]},"maxItems":100,"description":"Containment facts for geography and population (40,000 characters in total), e.g. {broader:'United States', narrower:['California','Texas']}. Transitive."}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"dimensions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"dimension":{"type":"string","enum":["geography","population","period","version","basis","unit"]},"verdict":{"type":"string","enum":["match","mismatch","unknown","not-declared"]},"claim":{"description":"Claimed value."},"evidence":{"description":"Evidence value."},"detail":{"type":"string"}}},"maxItems":6},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"dimensions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"dimension":{"type":"string","enum":["geography","population","period","version","basis","unit"]},"verdict":{"type":"string","enum":["match","mismatch","unknown","not-declared"]},"claim":{"description":"Claimed value."},"evidence":{"description":"Evidence value."},"detail":{"type":"string"}}},"maxItems":6},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"claim":{"geography":["Germany"],"period":{"start":"2025-01-01","end":"2025-12-31"},"basis":"per capita"},"evidence":{"geography":["Europe"],"period":{"start":"2019","end":"2019"},"basis":"total"},"taxonomy":[{"broader":"Europe","narrower":["Germany","France"]}]},"openapiOperation":{"operationId":"evidence_scope_mismatch","summary":"Check that evidence covers the scope of the claim it is used for (geography, population, period, version, basis, unit)","description":"Compares the scope descriptors of a claim and of the evidence offered for it, per dimension: geography and population (every claimed item must be equal to, or contained in a broader evidence item according to the caller's taxonomy), period (the evidence period must contain the claimed period; partial or no overlap is a mismatch), and version, basis and unit (must be equal after normalization). Descriptors are supplied by the caller; this check does not read text to find them, and without a taxonomy two different place or group names are unknown, never assumed related. A dimension the claim does not declare is not checked.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"agent-infra","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/evidence-scope-mismatch","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["claim","evidence"],"properties":{"claim":{"type":"object","additionalProperties":false,"properties":{"geography":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Places the statement covers (countries, regions, 'worldwide')."},"population":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Who/what is covered (adults, EU residents, Series A startups)."},"period":{"type":"object","additionalProperties":false,"properties":{"start":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD."},"end":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD, inclusive."}},"required":["start","end"]},"version":{"type":"string","maxLength":60,"description":"Software, standard or edition version."},"basis":{"type":"string","maxLength":100,"description":"Measurement basis: per capita, nominal, mean, gross, as-reported..."},"unit":{"type":"string","maxLength":60,"description":"Unit of measure."}},"description":"Scope of the claim being made."},"evidence":{"type":"object","additionalProperties":false,"properties":{"geography":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Places the statement covers (countries, regions, 'worldwide')."},"population":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20,"description":"Who/what is covered (adults, EU residents, Series A startups)."},"period":{"type":"object","additionalProperties":false,"properties":{"start":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD."},"end":{"type":"string","maxLength":10,"minLength":4,"description":"YYYY, YYYY-MM or YYYY-MM-DD, inclusive."}},"required":["start","end"]},"version":{"type":"string","maxLength":60,"description":"Software, standard or edition version."},"basis":{"type":"string","maxLength":100,"description":"Measurement basis: per capita, nominal, mean, gross, as-reported..."},"unit":{"type":"string","maxLength":60,"description":"Unit of measure."}},"description":"Scope of the evidence offered."},"taxonomy":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"broader":{"type":"string","maxLength":100,"minLength":1},"narrower":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":200}},"required":["broader","narrower"]},"maxItems":100,"description":"Containment facts for geography and population (40,000 characters in total), e.g. {broader:'United States', narrower:['California','Texas']}. Transitive."}}},"example":{"claim":{"geography":["Germany"],"period":{"start":"2025-01-01","end":"2025-12-31"},"basis":"per capita"},"evidence":{"geography":["Europe"],"period":{"start":"2019","end":"2019"},"basis":"total"},"taxonomy":[{"broader":"Europe","narrower":["Germany","France"]}]}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"dimensions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"dimension":{"type":"string","enum":["geography","population","period","version","basis","unit"]},"verdict":{"type":"string","enum":["match","mismatch","unknown","not-declared"]},"claim":{"description":"Claimed value."},"evidence":{"description":"Evidence value."},"detail":{"type":"string"}}},"maxItems":6},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/evidence-scope-mismatch/","docsJson":"https://agents.writerslogic.com/docs/evidence-scope-mismatch.json","sample":"https://agents.writerslogic.com/api/v1/samples/evidence-scope-mismatch","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}