{"openapi":"3.1.0","info":{"title":"Tollmint","version":"0.1.0","description":"Pay-per-call data and capability API for autonomous agents.\n\n## Two guarantees\n\n1. **The charged price never exceeds the quoted price.** The number in the 402 challenge binds us.\n2. **Failures that are ours cost you nothing.** Upstream errors void the authorization; on the x402 rail we simply never settle.\n\n## Money\n\nAll amounts are integer **micro-USD** (1e-6 USD). `$0.0002` is `200`. USDC has 6 decimals, so one micro-USD is exactly one USDC atomic unit and no conversion happens anywhere.\n\n## Paying\n\n- **x402** — call without credentials, receive a 402 with the price, sign the authorization, retry with `X-PAYMENT`. No account needed.\n- **Credits** — `Authorization: Bearer ak_live_…` against a prepaid balance.\n\nOverpayment on the x402 rail becomes ledger credit and is spent on your next call, which then skips the on-chain round-trip."},"servers":[{"url":"https://api.tollmint.com"}],"security":[{"apiKey":[]},{"x402":[]}],"paths":{"/v1/psych/dark-pattern-detect":{"post":{"operationId":"psych_dark_pattern_detect","summary":"Dark Pattern Detector","description":"Scan a live page or raw HTML for deceptive design. Returns each detected pattern with the evidence quoted from the markup, the regulation it trips, and the honest alternative. Fully deterministic — no model call, so results are reproducible and the same page always scores the same. Returns a clean/review/fail verdict suitable for gating a deploy. Names the patterns that need a full user flow to assess rather than implying the site is clean.\n\n**$0.030000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nNot cached.\nTarget latency p50 700ms / p99 4000ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Page to analyse. Fetched respecting robots.txt."},"html":{"type":"string","maxLength":2000000,"description":"Raw HTML, if you already have it. Takes precedence over url."},"jurisdiction":{"type":"string","maxLength":20,"description":"Filter findings to a jurisdiction, e.g. \"EU\" or \"US\". Omit for all."},"fail_above_severity":{"type":"integer","minimum":0,"maximum":100,"description":"Sets verdict to \"fail\" when any pattern meets or exceeds this severity. Useful in CI."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"url":{"type":["string","null"]},"verdict":{"type":"string","enum":["clean","review","fail"]},"highest_severity":{"type":"integer"},"patterns":{"type":"array","items":{"type":"object","properties":{"pattern_id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"severity":{"type":"integer"},"evidence":{"type":"array","items":{"type":"string"}},"regulatory_refs":{"type":"array","items":{"type":"object","properties":{"regulation":{"type":"string"},"jurisdiction":{"type":"string"},"concern":{"type":"string"}},"required":["regulation","jurisdiction","concern"],"additionalProperties":false}},"precedent":{"type":"array","items":{"type":"object","properties":{"target":{"type":"string"},"authority":{"type":"string"},"outcome":{"type":"string"},"penalty":{"type":["number","null"]},"currency":{"type":["string","null"]},"decision_date":{"type":["string","null"]},"source_url":{"type":"string"},"boundary_marker":{"type":"boolean"}},"required":["target","authority","outcome","penalty","currency","decision_date","source_url","boundary_marker"],"additionalProperties":false}}},"required":["pattern_id","name","category","severity","evidence","regulatory_refs","precedent"],"additionalProperties":false}},"not_assessable":{"type":"array","items":{"type":"object","properties":{"pattern_id":{"type":"string"},"reason":{"type":"string"}},"required":["pattern_id","reason"],"additionalProperties":false}},"filtered_to":{"type":["string","null"]},"jurisdictions_present":{"type":"array","items":{"type":"string"}}},"required":["url","verdict","highest_severity","patterns","not_assessable","filtered_to","jurisdictions_present"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/psych/cognitive-load":{"post":{"operationId":"psych_cognitive_load","summary":"Cognitive Load Score","description":"Measure the mental effort a page demands before a decision can be made: form fields, competing choices, interactive density, and reading burden. Deterministic and reproducible — the same markup always scores the same, so the number is usable for tracking a page over time or against a competitor. Choice count is weighted logarithmically per Hick's law rather than linearly, which is the law's most common misapplication.\n\n**$0.025000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nNot cached.\nTarget latency p50 700ms / p99 4000ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Page to analyse. Fetched respecting robots.txt."},"html":{"type":"string","maxLength":2000000,"description":"Raw HTML, if you already have it. Takes precedence over url."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"url":{"type":["string","null"]},"score":{"type":"integer","minimum":0,"maximum":100},"band":{"type":"string","enum":["low","moderate","high","severe"]},"drivers":{"type":"array","items":{"type":"string"}},"measurements":{"type":"object","properties":{"form_fields":{"type":"integer"},"choice_count":{"type":"integer"},"interactive_elements":{"type":"integer"},"word_count":{"type":"integer"},"heading_count":{"type":"integer"}},"required":["form_fields","choice_count","interactive_elements","word_count","heading_count"],"additionalProperties":false},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["url","score","band","drivers","measurements","recommendations"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/psych/trust-signals":{"post":{"operationId":"psych_trust_signals","summary":"Trust Signal Audit","description":"Check which trust signals a page carries and which it omits — pricing visibility, privacy and terms, contact routes, cancellation terms. Each gap is returned with the inference a visitor draws from its absence, because under ambiguity aversion missing information is read as adverse rather than neutral: a hidden price is inferred to be a high one. Deterministic, model-free, and reproducible.\n\n**$0.025000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nNot cached.\nTarget latency p50 700ms / p99 4000ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Page to analyse. Fetched respecting robots.txt."},"html":{"type":"string","maxLength":2000000,"description":"Raw HTML, if you already have it. Takes precedence over url."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"url":{"type":["string","null"]},"score":{"type":"integer","minimum":0,"maximum":100},"present":{"type":"array","items":{"type":"string"}},"missing":{"type":"array","items":{"type":"object","properties":{"signal":{"type":"string"},"inference":{"type":"string"}},"required":["signal","inference"],"additionalProperties":false}}},"required":["url","score","present","missing"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/psych/effects":{"post":{"operationId":"psych_effects","summary":"Behavioural Effects Corpus","description":"Query a curated corpus of behavioural science effects. Every entry carries its canonical citation, replication status (robust / mixed / contested / failed), effect size, and boundary conditions. Effects that failed replication are included and labelled, not hidden — filter with actionable_only to exclude them.\n\n**$0.001000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","enum":["decision","cognition","memory","social","emotion","motivation","perception","ux"]},"replication_status":{"type":"array","items":{"type":"string","enum":["robust","mixed","contested","failed","untested"]}},"actionable_only":{"type":"boolean","default":false,"description":"Return only effects safe to act on without human review (robust and mixed)"},"max_manipulation_baseline":{"type":"integer","minimum":0,"maximum":100,"description":"Exclude effects whose inherent manipulation risk exceeds this threshold"},"search":{"type":"string","maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"offset":{"type":"integer","minimum":0,"default":0}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"effects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"mechanism":{"type":"string"},"replication_status":{"type":"string","enum":["robust","mixed","contested","failed","untested"]},"canonical_source":{"type":"object","properties":{"authors":{"type":"string"},"year":{"type":"integer"},"title":{"type":"string"},"venue":{"type":"string"},"doi":{"type":"string"},"url":{"type":"string"}},"required":["authors","year","title"],"additionalProperties":false},"supporting_sources":{"type":"array","items":{"$ref":"#/properties/effects/items/properties/canonical_source"}},"typical_effect_size":{"type":["string","null"]},"confidence":{"type":"number"},"caveats":{"type":"array","items":{"type":"string"}},"applications":{"type":"array","items":{"type":"object","properties":{"context":{"type":"string"},"tactic":{"type":"string"},"example":{"type":"string"},"expected_direction":{"type":"string","enum":["increase","decrease","shift","unclear"]}},"required":["context","tactic","example","expected_direction"],"additionalProperties":false}},"manipulation_baseline":{"type":"integer"},"countermeasures":{"type":"array","items":{"type":"string"}},"related_effects":{"type":"array","items":{"type":"string"}},"moderators":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["moderator","cultural"]},"condition":{"type":"string"},"condition_type":{"type":"string"},"direction":{"type":"string","enum":["attenuates","amplifies","eliminates","reverses","unchanged"]},"magnitude":{"type":"string"},"evidence_type":{"type":"string"},"k_studies":{"anyOf":[{"type":"integer"},{"type":"null"}]},"n_total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"citation":{"type":"string"},"source_url":{"type":["string","null"]},"citable":{"type":"boolean"},"confidence":{"type":"string","enum":["high","medium","low"]},"note":{"type":"string"},"is_reversal":{"type":"boolean"}},"required":["kind","condition","condition_type","direction","magnitude","evidence_type","k_studies","n_total","citation","source_url","citable","confidence","note","is_reversal"],"additionalProperties":false}},"moderator_coverage":{"type":"object","properties":{"moderators_known":{"type":"integer"},"reversals_known":{"type":"integer"},"not_yet_researched":{"type":"boolean"},"no_cross_cultural_evidence":{"type":"boolean"},"note":{"type":"string"}},"required":["moderators_known","reversals_known","not_yet_researched","no_cross_cultural_evidence","note"],"additionalProperties":false}},"required":["id","name","domain","mechanism","replication_status","canonical_source","supporting_sources","typical_effect_size","confidence","caveats","applications","manipulation_baseline","countermeasures","related_effects","moderators","moderator_coverage"],"additionalProperties":false}},"total":{"type":"integer"},"excluded_failed":{"type":"integer"},"corpus":{"type":"object","properties":{"total":{"type":"integer"},"by_replication_status":{"type":"object","additionalProperties":{"type":"number"}},"version":{"type":"string"}},"required":["total","by_replication_status","version"],"additionalProperties":false},"field_vs_lab":{"type":"object","properties":{"finding":{"type":"string"},"k_studies":{"type":"integer"},"n_total":{"type":"integer"},"citation":{"type":"string"},"source_url":{"type":"string"},"cause":{"type":"string"},"implication":{"type":"string"}},"required":["finding","k_studies","n_total","citation","source_url","cause","implication"],"additionalProperties":false}},"required":["effects","total","excluded_failed","corpus","field_vs_lab"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/psych/biases":{"post":{"operationId":"psych_biases","summary":"Cognitive Bias Taxonomy","description":"Cognitive biases with their mechanism, the conditions that trigger them, documented countermeasures, and an exploitation-risk score. Every entry carries its citation and replication status. Use to audit a decision process, to harden a system against manipulation, or to check your own reasoning.\n\n**$0.001500 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","enum":["decision","cognition","memory","social","emotion","motivation","perception","ux"]},"replication_status":{"type":"array","items":{"type":"string","enum":["robust","mixed","contested","failed","untested"]}},"actionable_only":{"type":"boolean","default":true,"description":"Exclude effects that failed replication. Defaults true — countering a non-existent bias wastes effort."},"search":{"type":"string","maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"offset":{"type":"integer","minimum":0,"default":0}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"biases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"mechanism":{"type":"string"},"replication_status":{"type":"string","enum":["robust","mixed","contested","failed","untested"]},"typical_effect_size":{"type":["string","null"]},"confidence":{"type":"number"},"caveats":{"type":"array","items":{"type":"string"}},"countermeasures":{"type":"array","items":{"type":"string"}},"exploitation_risk":{"type":"integer"},"canonical_source":{"type":"object","properties":{"authors":{"type":"string"},"year":{"type":"integer"},"title":{"type":"string"},"venue":{"type":"string"},"doi":{"type":"string"}},"required":["authors","year","title"],"additionalProperties":false},"related_effects":{"type":"array","items":{"type":"string"}}},"required":["id","name","domain","mechanism","replication_status","typical_effect_size","confidence","caveats","countermeasures","exploitation_risk","canonical_source","related_effects"],"additionalProperties":false}},"total":{"type":"integer"},"excluded_failed":{"type":"integer"},"corpus_version":{"type":"string"}},"required":["biases","total","excluded_failed","corpus_version"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/psych/dark-patterns":{"post":{"operationId":"psych_dark_patterns","summary":"Dark Pattern Taxonomy","description":"Deceptive-design taxonomy with the regulation each pattern trips (EU DSA Art. 25, UCPD, FTC ROSCA and the Negative Option Rule), the signals that detect it in markup or copy, a severity score, and the honest alternative that achieves the same business goal. Use before shipping conversion changes, or to audit a competitor.\n\n**$0.002000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["obstruction","sneaking","urgency","misdirection","social-proof-abuse","scarcity-abuse","forced-action","interface-interference"]},"min_severity":{"type":"integer","minimum":0,"maximum":100},"jurisdiction":{"type":"string","maxLength":20,"description":"Filter to patterns regulated in a jurisdiction, e.g. \"EU\" or \"US\""},"search":{"type":"string","maxLength":200}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"patterns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","enum":["obstruction","sneaking","urgency","misdirection","social-proof-abuse","scarcity-abuse","forced-action","interface-interference"]},"description":{"type":"string"},"detection_signals":{"type":"array","items":{"type":"string"}},"regulatory_refs":{"type":"array","items":{"type":"object","properties":{"regulation":{"type":"string"},"jurisdiction":{"type":"string"},"concern":{"type":"string"}},"required":["regulation","jurisdiction","concern"],"additionalProperties":false}},"severity":{"type":"integer"},"ethical_alternative":{"type":"string"}},"required":["id","name","category","description","detection_signals","regulatory_refs","severity","ethical_alternative"],"additionalProperties":false}},"total":{"type":"integer"},"jurisdictions":{"type":"array","items":{"type":"string"}},"high_risk_count":{"type":"integer"}},"required":["patterns","total","jurisdictions","high_risk_count"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/psych/enforcement":{"post":{"operationId":"psych_enforcement","summary":"Deceptive Design Enforcement Record","description":"Regulatory enforcement actions over deceptive interface design, each citing the regulator’s own document: the law and article, the company, the penalty, and what was actually on the screen. Includes dismissals, vacated rules and findings of lawfulness, which mark where the line sits and which fine-only lists omit. Also reports patterns prohibited but never enforced, and cases excluded for want of a primary source. Use to tell whether a design choice has cost anyone money, and where.\n\n**$0.004000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pattern":{"type":"string","maxLength":40,"description":"Pattern to look up. Accepts our taxonomy ids (roach-motel, fake-urgency, hidden-costs, trick-wording, forced-continuity) or enforcement terms (drip-pricing, preselected-consent, obstruction, privacy-zuckering, bait-and-switch, disguised-ads)."},"jurisdiction":{"type":"string","maxLength":30,"description":"Substring match: \"EU\", \"UK\", \"US-federal\", \"US-state\", \"France\", \"India\"."},"outcome":{"type":"string","enum":["fined","settled","injunction","consent-decree","dismissed","found-lawful","ongoing"]},"boundary_only":{"type":"boolean","default":false,"description":"Return only outcomes that bound the rule — dismissals, vacated rules, findings of lawfulness. These say what is permitted, which fines cannot."},"min_penalty":{"type":"integer","minimum":0,"description":"Minimum penalty in the record currency. Rows with no penalty are excluded."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"pattern":{"type":"string"},"taxonomy_id":{"type":["string","null"]},"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"in_force_date":{"type":"string"},"prohibits":{"type":"string"},"authority":{"type":"string"},"target":{"type":"string"},"decision_date":{"type":["string","null"]},"outcome":{"type":"string","enum":["fined","settled","injunction","consent-decree","dismissed","found-lawful","ongoing"]},"penalty":{"type":["number","null"]},"currency":{"type":["string","null"]},"summary":{"type":"string"},"source_url":{"type":"string"},"source_type":{"type":"string"},"boundary_marker":{"type":"boolean"},"notes":{"type":["string","null"]}},"required":["id","pattern","taxonomy_id","jurisdiction","instrument","in_force_date","prohibits","authority","target","decision_date","outcome","penalty","currency","summary","source_url","source_type","boundary_marker","notes"],"additionalProperties":false}},"total":{"type":"integer"},"boundary_markers":{"type":"integer"},"largest_penalty":{"anyOf":[{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"},"target":{"type":"string"}},"required":["amount","currency","target"],"additionalProperties":false},{"type":"null"}]},"coverage":{"type":"object","properties":{"corpus_total":{"type":"integer"},"matched":{"type":"integer"},"pattern_recognised":{"type":"boolean"},"unenforced_anywhere":{"type":"array","items":{"type":"object","properties":{"pattern":{"type":"string"},"note":{"type":"string"}},"required":["pattern","note"],"additionalProperties":false}},"law_without_enforcement":{"type":"array","items":{"type":"object","properties":{"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"in_force_date":{"type":"string"},"note":{"type":"string"}},"required":["jurisdiction","instrument","in_force_date","note"],"additionalProperties":false}},"excluded_for_no_primary_source":{"type":"array","items":{"type":"object","properties":{"target":{"type":"string"},"authority":{"type":"string"},"reported":{"type":"string"}},"required":["target","authority","reported"],"additionalProperties":false}},"note":{"type":"string"}},"required":["corpus_total","matched","pattern_recognised","unenforced_anywhere","law_without_enforcement","excluded_for_no_primary_source","note"],"additionalProperties":false},"interpretation":{"type":"string"}},"required":["actions","total","boundary_markers","largest_penalty","coverage","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/psych/heuristics":{"post":{"operationId":"psych_heuristics","summary":"Interaction Design Laws","description":"Interaction-design laws with their formulae, sources, and design implications — Fitts, Hick, Jakob, Tesler, Doherty. Includes the common misapplications, since these are misquoted more often than they are wrong. Separate from the effects corpus because these are engineering constraints, not contested empirical claims.\n\n**$0.001000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 604800s; a cache hit costs 10% of full price.\nTarget latency p50 10ms / p99 40ms.","tags":["psych"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"search":{"type":"string","maxLength":200},"with_formula":{"type":"boolean","default":false}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"heuristics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"statement":{"type":"string"},"formula":{"type":["string","null"]},"implications":{"type":"array","items":{"type":"string"}},"source":{"type":"object","properties":{"authors":{"type":"string"},"year":{"type":"integer"},"title":{"type":"string"},"venue":{"type":"string"},"doi":{"type":"string"},"url":{"type":"string"}},"required":["authors","year","title"],"additionalProperties":false}},"required":["id","name","statement","formula","implications","source"],"additionalProperties":false}},"total":{"type":"integer"},"corpus_version":{"type":"string"}},"required":["heuristics","total","corpus_version"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/content/ai-score":{"post":{"operationId":"content_ai_score","summary":"Mechanical Style Score","description":"Measure how mechanically a piece of text reads across 19 stylistic signals: sentence-length variance (burstiness), em-dash rate, negative parallelism, copula avoidance, the characteristic AI vocabulary cluster, hedged superlatives, significance inflation, puffery, vague attribution, over-signposting, formatting tics, and more. Returns a per-sentence breakdown naming which signal each one tripped. Deterministic and model-free, so before-and-after comparisons across an edit are meaningful. NOT an AI detector — it reports stylistic properties, never authorship, and returns no verdict or probability. Authorship classifiers are unreliable and disproportionately misjudge non-native English writers.\n\n**$0.004000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 604800s; a cache hit costs 10% of full price.\nTarget latency p50 20ms / p99 80ms.","tags":["content"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":50000},"include_sentences":{"type":"boolean","default":true}},"required":["text"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"mechanical_style_score":{"type":"integer","minimum":0,"maximum":100},"signals":{"type":"array","items":{"type":"string","enum":["uniform_sentence_length","no_short_sentences","em_dash_overuse","negative_parallelism","rule_of_three","parallel_structure","hedging","abstract_diction","copula_avoidance","ai_vocabulary","hedged_superlative","participle_openers","significance_inflation","puffery","vague_attribution","transition_scaffolding","over_signposting","outline_conclusion","formatting_tics"]}},"metrics":{"type":"object","properties":{"sentence_count":{"type":"number"},"word_count":{"type":"number"},"mean_sentence_length":{"type":"number"},"sentence_length_sd":{"type":"number"},"burstiness":{"type":"number"},"hedge_density_per_100w":{"type":"number"},"transition_density_per_100w":{"type":"number"},"abstract_noun_ratio":{"type":"number"},"short_sentence_ratio":{"type":"number"},"em_dash_per_1k":{"type":"number"},"rule_of_three_count":{"type":"number"},"reading_level":{"type":"number"}},"required":["sentence_count","word_count","mean_sentence_length","sentence_length_sd","burstiness","hedge_density_per_100w","transition_density_per_100w","abstract_noun_ratio","short_sentence_ratio","em_dash_per_1k","rule_of_three_count","reading_level"],"additionalProperties":false},"sentences":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"text":{"type":"string"},"score":{"type":"number"},"signals":{"type":"array","items":{"$ref":"#/properties/signals/items"}}},"required":["index","text","score","signals"],"additionalProperties":false}},"suggestions":{"type":"array","items":{"type":"string"}},"interpretation":{"type":"string"}},"required":["mechanical_style_score","signals","metrics","sentences","suggestions","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/design/ai-slop-detect":{"post":{"operationId":"design_ai_slop_detect","summary":"Template Convergence Detector","description":"Score how closely a page matches the documented 2025-2026 AI/template design fingerprint: the Tailwind indigo-violet gradient, a default sans with no display pairing, the badge/hero/three-card/steps/testimonial/pricing skeleton, glassmorphism, uniform border radii, emoji feature bullets, round-number social proof with no attribution, and abstract illustration in place of the product. Each finding quotes the markup that produced it and names the move that breaks the pattern. Deterministic and model-free. Reports template convergence, never authorship — the same fingerprint appears in human sites built from the same tutorials.\n\n**$0.025000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nNot cached.\nTarget latency p50 700ms / p99 4000ms.","tags":["design"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Page to analyse. Fetched respecting robots.txt."},"html":{"type":"string","maxLength":2000000,"description":"Raw HTML, if you already have it. Takes precedence over url."},"fail_above_score":{"type":"integer","minimum":0,"maximum":100,"description":"Set a verdict of \"fail\" above this score. Useful for gating a design review in CI."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"url":{"type":["string","null"]},"score":{"type":"integer","minimum":0,"maximum":100},"band":{"type":"string","enum":["distinctive","conventional","templated","indistinguishable"]},"verdict":{"type":"string","enum":["pass","review","fail"]},"signals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"evidence":{"type":"array","items":{"type":"string"}},"weight":{"type":"integer"},"alternative":{"type":"string"}},"required":["id","name","evidence","weight","alternative"],"additionalProperties":false}},"clean":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","properties":{"external_css_likely":{"type":"boolean"},"inline_style_bytes":{"type":"integer"},"note":{"type":"string"}},"required":["external_css_likely","inline_style_bytes","note"],"additionalProperties":false},"interpretation":{"type":"string"}},"required":["url","score","band","verdict","signals","clean","coverage","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/web/fetch":{"post":{"operationId":"web_fetch","summary":"Fetch Page as Markdown","description":"Fetch a URL and return the main content as clean markdown, with navigation, cookie banners, footers, and related-post chrome removed. Extracts title, byline, publication date, and excerpt. Content detection is driven by link density rather than class names, so it survives CSS refactors. Reports how much of the page was retained and whether it had to fall back to the full body, so you can tell a clean extraction from a guess. Honours robots.txt; refuses private addresses and pages behind authentication.\n\n**$0.003000 per call**, flat.\n\nSourcing class **C**. License: content remains the property of its publisher.\nCached for 86400s; a cache hit costs 20% of full price.\nTarget latency p50 900ms / p99 5000ms.","tags":["web"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Page to analyse. Fetched respecting robots.txt."},"html":{"type":"string","maxLength":2000000,"description":"Raw HTML, if you already have it. Takes precedence over url."},"include_links":{"type":"boolean","default":true,"description":"Keep inline links as markdown. Disable to cut tokens when only prose matters."},"max_words":{"type":"integer","minimum":100,"maximum":50000,"description":"Truncate the markdown at this many words. Truncation is reported."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"url":{"type":["string","null"]},"title":{"type":["string","null"]},"excerpt":{"type":["string","null"]},"byline":{"type":["string","null"]},"published_at":{"type":["string","null"]},"markdown":{"type":"string"},"word_count":{"type":"integer"},"truncated":{"type":"boolean"},"extraction":{"type":"object","properties":{"retained_ratio":{"type":"number"},"used_fallback":{"type":"boolean"}},"required":["retained_ratio","used_fallback"],"additionalProperties":false}},"required":["url","title","excerpt","byline","published_at","markdown","word_count","truncated","extraction"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/ref/geocode":{"post":{"operationId":"ref_geocode","summary":"Geocode","description":"Convert a free-form address or place name into coordinates with normalised address components, a calibrated confidence score, and precision classification (rooftop / street / locality / region / country). Deduplicates OSM elements and flags ambiguous queries with the competing alternatives. Data from OpenStreetMap.\n\n**$0.000800 per call**, flat.\n\nSourcing class **C**. License: ODbL-1.0 (OpenStreetMap contributors).\nCached for 2592000s; a cache hit costs 20% of full price.\nTarget latency p50 180ms / p99 900ms.","tags":["ref"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Free-form address or place name"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"country_codes":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"maxItems":10,"description":"ISO 3166-1 alpha-2 codes to restrict the search"}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"query":{"type":"string"},"best":{"anyOf":[{"type":"object","properties":{"formatted":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"precision":{"type":"string","enum":["rooftop","street","locality","region","country"]},"confidence":{"type":"number","minimum":0,"maximum":1},"address":{"type":"object","properties":{"house_number":{"type":["string","null"]},"street":{"type":["string","null"]},"locality":{"type":["string","null"]},"district":{"type":["string","null"]},"region":{"type":["string","null"]},"postcode":{"type":["string","null"]},"country":{"type":["string","null"]},"country_code":{"type":["string","null"]}},"required":["house_number","street","locality","district","region","postcode","country","country_code"],"additionalProperties":false},"category":{"type":"string"},"type":{"type":"string"},"bounding_box":{"anyOf":[{"type":"object","properties":{"south":{"type":"number"},"north":{"type":"number"},"west":{"type":"number"},"east":{"type":"number"}},"required":["south","north","west","east"],"additionalProperties":false},{"type":"null"}]},"osm_id":{"type":["number","null"]},"osm_type":{"type":["string","null"]}},"required":["formatted","lat","lon","precision","confidence","address","category","type","bounding_box","osm_id","osm_type"],"additionalProperties":false},{"type":"null"}]},"results":{"type":"array","items":{"$ref":"#/properties/best/anyOf/0"}},"ambiguous":{"type":"boolean"},"alternatives":{"type":"array","items":{"type":"string"}}},"required":["query","best","results","ambiguous","alternatives"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/legal/ai-disclosure":{"post":{"operationId":"legal_ai_disclosure","summary":"AI Disclosure Obligations","description":"Binding obligations worldwide to disclose, label, or watermark AI-generated content — EU AI Act Art. 50, California SB 942 and AB 2013, China’s 2025 labelling Measures, South Korea’s AI Basic Act, India’s 2026 IT Rules. Each row gives the exact trigger condition, what must be done, the exemptions, the penalty ceiling, and whether anyone has been enforced against yet. Includes forward dates for obligations already enacted but not yet biting, and records the California election-deepfake laws that were struck down in 2025 and are still widely cited as live. Query before shipping generated content into a jurisdiction.\n\n**$0.006000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["legal"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string","maxLength":40,"description":"Substring match, e.g. \"EU\", \"UK\", \"US-federal\", \"California\", \"Germany\"."},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"],"description":"Filter to one lifecycle state."},"dead_only":{"type":"boolean","default":false,"description":"Return only rules that are NOT live law — vacated, superseded, or still proposed. These are the rules most often wrongly believed to be in force."},"verified_only":{"type":"boolean","default":false,"description":"Only rows whose source URL resolved when last checked. Off by default: many primary sources (courts, national gazettes) block automated checkers, so \"blocked\" is not \"bad\"."},"search":{"type":"string","maxLength":200,"description":"Free-text over summary, instrument and detail."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"dataset":{"type":"string"},"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"]},"summary":{"type":"string"},"source_url":{"type":"string"},"source_status":{"type":"string","enum":["verified","blocked","unreachable"]},"not_live_law":{"type":"boolean"},"detail":{"type":"object","additionalProperties":{}}},"required":["id","dataset","jurisdiction","instrument","status","summary","source_url","source_status","not_live_law","detail"],"additionalProperties":false}},"total":{"type":"integer"},"coverage":{"type":"object","properties":{"corpus_total":{"type":"integer"},"matched":{"type":"integer"},"jurisdictions_in_corpus":{"type":"array","items":{"type":"string"}},"by_status":{"type":"object","additionalProperties":{"type":"number"}},"source_health":{"type":"object","additionalProperties":{"type":"number"}},"dead_rules_included":{"type":"integer"}},"required":["corpus_total","matched","jurisdictions_in_corpus","by_status","source_health","dead_rules_included"],"additionalProperties":false},"as_of":{"type":"string"},"interpretation":{"type":"string"}},"required":["records","total","coverage","as_of","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/legal/claims":{"post":{"operationId":"legal_claims","summary":"Marketing Claim Substantiation","description":"Which marketing claims legally require evidence, and what evidence suffices. Covers superlatives, health and efficacy, \"free\", environmental and carbon-neutral claims, reference and \"was/now\" pricing, \"up to X%\", reviews and testimonials, country of origin, guarantees, and AI-capability claims. Each row gives the regulator’s own evidentiary standard, the common way advertisers fail it, and enforcement with penalties where it exists. Also records five widely repeated \"you can’t say that\" rules that no instrument actually supports.\n\n**$0.005000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["legal"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string","maxLength":40,"description":"Substring match, e.g. \"EU\", \"UK\", \"US-federal\", \"California\", \"Germany\"."},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"],"description":"Filter to one lifecycle state."},"dead_only":{"type":"boolean","default":false,"description":"Return only rules that are NOT live law — vacated, superseded, or still proposed. These are the rules most often wrongly believed to be in force."},"verified_only":{"type":"boolean","default":false,"description":"Only rows whose source URL resolved when last checked. Off by default: many primary sources (courts, national gazettes) block automated checkers, so \"blocked\" is not \"bad\"."},"search":{"type":"string","maxLength":200,"description":"Free-text over summary, instrument and detail."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"dataset":{"type":"string"},"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"]},"summary":{"type":"string"},"source_url":{"type":"string"},"source_status":{"type":"string","enum":["verified","blocked","unreachable"]},"not_live_law":{"type":"boolean"},"detail":{"type":"object","additionalProperties":{}}},"required":["id","dataset","jurisdiction","instrument","status","summary","source_url","source_status","not_live_law","detail"],"additionalProperties":false}},"total":{"type":"integer"},"coverage":{"type":"object","properties":{"corpus_total":{"type":"integer"},"matched":{"type":"integer"},"jurisdictions_in_corpus":{"type":"array","items":{"type":"string"}},"by_status":{"type":"object","additionalProperties":{"type":"number"}},"source_health":{"type":"object","additionalProperties":{"type":"number"}},"dead_rules_included":{"type":"integer"}},"required":["corpus_total","matched","jurisdictions_in_corpus","by_status","source_health","dead_rules_included"],"additionalProperties":false},"as_of":{"type":"string"},"interpretation":{"type":"string"}},"required":["records","total","coverage","as_of","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/legal/subscriptions":{"post":{"operationId":"legal_subscriptions","summary":"Subscription and Price Display Law","description":"Rules on subscription sign-up, auto-renewal, cancellation, and total-price display across US federal, US states, EU, UK, France and Germany — with the numbers: how many days before renewal a reminder is due, how many clicks cancellation may take, what must be in the price. Critically, it records that the FTC’s \"Click-to-Cancel\" rule was vacated on 2025-07-08 before it ever took effect, along with the vacated DOT ancillary-fee rule and the twice-delayed UK subscription regime. A model working from training data will assert all three as live law.\n\n**$0.005000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["legal"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string","maxLength":40,"description":"Substring match, e.g. \"EU\", \"UK\", \"US-federal\", \"California\", \"Germany\"."},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"],"description":"Filter to one lifecycle state."},"dead_only":{"type":"boolean","default":false,"description":"Return only rules that are NOT live law — vacated, superseded, or still proposed. These are the rules most often wrongly believed to be in force."},"verified_only":{"type":"boolean","default":false,"description":"Only rows whose source URL resolved when last checked. Off by default: many primary sources (courts, national gazettes) block automated checkers, so \"blocked\" is not \"bad\"."},"search":{"type":"string","maxLength":200,"description":"Free-text over summary, instrument and detail."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"dataset":{"type":"string"},"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"]},"summary":{"type":"string"},"source_url":{"type":"string"},"source_status":{"type":"string","enum":["verified","blocked","unreachable"]},"not_live_law":{"type":"boolean"},"detail":{"type":"object","additionalProperties":{}}},"required":["id","dataset","jurisdiction","instrument","status","summary","source_url","source_status","not_live_law","detail"],"additionalProperties":false}},"total":{"type":"integer"},"coverage":{"type":"object","properties":{"corpus_total":{"type":"integer"},"matched":{"type":"integer"},"jurisdictions_in_corpus":{"type":"array","items":{"type":"string"}},"by_status":{"type":"object","additionalProperties":{"type":"number"}},"source_health":{"type":"object","additionalProperties":{"type":"number"}},"dead_rules_included":{"type":"integer"}},"required":["corpus_total","matched","jurisdictions_in_corpus","by_status","source_health","dead_rules_included"],"additionalProperties":false},"as_of":{"type":"string"},"interpretation":{"type":"string"}},"required":["records","total","coverage","as_of","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/legal/messaging":{"post":{"operationId":"legal_messaging","summary":"Outreach and Messaging Compliance","description":"When a commercial email, SMS, or call may lawfully be sent, by channel and jurisdiction. The field that matters is consent_model: the US is opt-out for email, Canada and the EU are opt-in, and Germany applies opt-in to B2B while France and the Netherlands do not. Applying the US model abroad is a breach. Includes opt-out deadlines, permitted calling hours, whether a private right of action exists (the difference between a regulator fine and a class action), and the FCC one-to-one consent rule vacated a day before it took effect.\n\n**$0.005000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["legal"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string","maxLength":40,"description":"Substring match, e.g. \"EU\", \"UK\", \"US-federal\", \"California\", \"Germany\"."},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"],"description":"Filter to one lifecycle state."},"dead_only":{"type":"boolean","default":false,"description":"Return only rules that are NOT live law — vacated, superseded, or still proposed. These are the rules most often wrongly believed to be in force."},"verified_only":{"type":"boolean","default":false,"description":"Only rows whose source URL resolved when last checked. Off by default: many primary sources (courts, national gazettes) block automated checkers, so \"blocked\" is not \"bad\"."},"search":{"type":"string","maxLength":200,"description":"Free-text over summary, instrument and detail."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"dataset":{"type":"string"},"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"]},"summary":{"type":"string"},"source_url":{"type":"string"},"source_status":{"type":"string","enum":["verified","blocked","unreachable"]},"not_live_law":{"type":"boolean"},"detail":{"type":"object","additionalProperties":{}}},"required":["id","dataset","jurisdiction","instrument","status","summary","source_url","source_status","not_live_law","detail"],"additionalProperties":false}},"total":{"type":"integer"},"coverage":{"type":"object","properties":{"corpus_total":{"type":"integer"},"matched":{"type":"integer"},"jurisdictions_in_corpus":{"type":"array","items":{"type":"string"}},"by_status":{"type":"object","additionalProperties":{"type":"number"}},"source_health":{"type":"object","additionalProperties":{"type":"number"}},"dead_rules_included":{"type":"integer"}},"required":["corpus_total","matched","jurisdictions_in_corpus","by_status","source_health","dead_rules_included"],"additionalProperties":false},"as_of":{"type":"string"},"interpretation":{"type":"string"}},"required":["records","total","coverage","as_of","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/legal/accessibility":{"post":{"operationId":"legal_accessibility","summary":"Web Accessibility Obligations and Enforcement","description":"Accessibility duties and the cases brought under them: ADA Titles II and III, Section 508, the European Accessibility Act in force since 2025-06-28, EN 301 549, UK and Canadian regimes — with the WCAG version and conformance level each one actually incorporates, the microenterprise and undue-burden carve-outs, and compliance dates still ahead. Enforcement rows include the FTC’s $1M action against an accessibility overlay vendor and a case where a site running an overlay was sued anyway, plus defence wins that mark the limits.\n\n**$0.005000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["legal"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string","maxLength":40,"description":"Substring match, e.g. \"EU\", \"UK\", \"US-federal\", \"California\", \"Germany\"."},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"],"description":"Filter to one lifecycle state."},"dead_only":{"type":"boolean","default":false,"description":"Return only rules that are NOT live law — vacated, superseded, or still proposed. These are the rules most often wrongly believed to be in force."},"verified_only":{"type":"boolean","default":false,"description":"Only rows whose source URL resolved when last checked. Off by default: many primary sources (courts, national gazettes) block automated checkers, so \"blocked\" is not \"bad\"."},"search":{"type":"string","maxLength":200,"description":"Free-text over summary, instrument and detail."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"dataset":{"type":"string"},"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"]},"summary":{"type":"string"},"source_url":{"type":"string"},"source_status":{"type":"string","enum":["verified","blocked","unreachable"]},"not_live_law":{"type":"boolean"},"detail":{"type":"object","additionalProperties":{}}},"required":["id","dataset","jurisdiction","instrument","status","summary","source_url","source_status","not_live_law","detail"],"additionalProperties":false}},"total":{"type":"integer"},"coverage":{"type":"object","properties":{"corpus_total":{"type":"integer"},"matched":{"type":"integer"},"jurisdictions_in_corpus":{"type":"array","items":{"type":"string"}},"by_status":{"type":"object","additionalProperties":{"type":"number"}},"source_health":{"type":"object","additionalProperties":{"type":"number"}},"dead_rules_included":{"type":"integer"}},"required":["corpus_total","matched","jurisdictions_in_corpus","by_status","source_health","dead_rules_included"],"additionalProperties":false},"as_of":{"type":"string"},"interpretation":{"type":"string"}},"required":["records","total","coverage","as_of","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/legal/scraping":{"post":{"operationId":"legal_scraping","summary":"Automated Data Collection Legality","description":"What courts have actually held about scraping, crawling, and training-data acquisition. Answers questions in the form an engineer asks them: does ignoring robots.txt create liability, does a browsewrap bind a bot, is public data outside the CFAA. Records binding scope honestly — a Ninth Circuit holding is not US law — and tracks the full history of hiQ v LinkedIn, which is routinely cited as making scraping legal and which hiQ ultimately lost on contract. Covers the EU text-and-data-mining exceptions and their opt-out.\n\n**$0.004000 per call**, flat.\n\nSourcing class **B**. License: proprietary.\nCached for 86400s; a cache hit costs 10% of full price.\nTarget latency p50 15ms / p99 60ms.","tags":["legal"],"security":[{"apiKey":[]},{"x402":[]},{}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Retry-safe key. A repeat with the same key and body replays the original response and is not charged again."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string","maxLength":40,"description":"Substring match, e.g. \"EU\", \"UK\", \"US-federal\", \"California\", \"Germany\"."},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"],"description":"Filter to one lifecycle state."},"dead_only":{"type":"boolean","default":false,"description":"Return only rules that are NOT live law — vacated, superseded, or still proposed. These are the rules most often wrongly believed to be in force."},"verified_only":{"type":"boolean","default":false,"description":"Only rows whose source URL resolved when last checked. Off by default: many primary sources (courts, national gazettes) block automated checkers, so \"blocked\" is not \"bad\"."},"search":{"type":"string","maxLength":200,"description":"Free-text over summary, instrument and detail."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Success. Charged at most the quoted price.","content":{"application/json":{"schema":{"type":"object","required":["data","_meta"],"properties":{"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"dataset":{"type":"string"},"jurisdiction":{"type":"string"},"instrument":{"type":"string"},"status":{"type":"string","enum":["in-force","enacted-not-yet-in-force","proposed","vacated","superseded","unknown"]},"summary":{"type":"string"},"source_url":{"type":"string"},"source_status":{"type":"string","enum":["verified","blocked","unreachable"]},"not_live_law":{"type":"boolean"},"detail":{"type":"object","additionalProperties":{}}},"required":["id","dataset","jurisdiction","instrument","status","summary","source_url","source_status","not_live_law","detail"],"additionalProperties":false}},"total":{"type":"integer"},"coverage":{"type":"object","properties":{"corpus_total":{"type":"integer"},"matched":{"type":"integer"},"jurisdictions_in_corpus":{"type":"array","items":{"type":"string"}},"by_status":{"type":"object","additionalProperties":{"type":"number"}},"source_health":{"type":"object","additionalProperties":{"type":"number"}},"dead_rules_included":{"type":"integer"}},"required":["corpus_total","matched","jurisdictions_in_corpus","by_status","source_health","dead_rules_included"],"additionalProperties":false},"as_of":{"type":"string"},"interpretation":{"type":"string"}},"required":["records","total","coverage","as_of","interpretation"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"evidence":{"$ref":"#/components/schemas/Evidence"},"manipulation_risk":{"$ref":"#/components/schemas/ManipulationRisk"},"_meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}},"402":{"description":"Payment required. Not an error — this is the price. The body is an x402 challenge; sign it and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Input failed schema validation. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream failure. Not charged — the hold is voided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Prepaid credits. `Authorization: Bearer ak_live_…`"},"x402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"Base64-encoded x402 payment payload. Obtain the requirements from the 402 response."}},"schemas":{"ResponseMeta":{"type":"object","description":"Rides on every successful response. An autonomous buyer cannot file a support ticket, so everything it needs to audit the call is in the response itself.","required":["request_id","product","version","cost","cache","provenance","freshness","confidence"],"properties":{"request_id":{"type":"string"},"product":{"type":"string"},"version":{"type":"string"},"cost":{"type":"object","properties":{"quoted":{"type":"integer","description":"micro-USD quoted before execution"},"charged":{"type":"integer","description":"micro-USD actually charged; never exceeds quoted"},"currency":{"type":"string","enum":["USD"]},"display":{"type":"string","example":"0.001000"}}},"cache":{"type":"object","properties":{"hit":{"type":"boolean"},"age_s":{"type":["integer","null"]}}},"provenance":{"type":"object","properties":{"sourcing_class":{"type":"string","enum":["A","B","C","D"],"description":"A generated, B curated, C public, D licensed"},"upstream":{"type":"array","items":{"type":"string"}},"fetched_at":{"type":"string","format":"date-time"},"license":{"type":"string"}}},"freshness":{"type":"object","properties":{"as_of":{"type":"string"},"staleness_s":{"type":"integer"}}},"confidence":{"type":"number","minimum":0,"maximum":1}}},"Evidence":{"type":"array","description":"Present on graded products. Each entry carries the citation, replication status, and boundary conditions for the effect being applied.","items":{"type":"object","properties":{"effect":{"type":"string"},"canonical_source":{"type":"object","properties":{"authors":{"type":"string"},"year":{"type":"integer"},"title":{"type":"string"},"venue":{"type":"string"},"doi":{"type":"string"}}},"replication_status":{"type":"string","enum":["robust","mixed","contested","failed","untested"],"description":"Filter on this. Effects that failed replication are served and labelled, not hidden."},"typical_effect_size":{"type":["string","null"]},"confidence":{"type":"number"},"caveats":{"type":"array","items":{"type":"string"}}}}},"ManipulationRisk":{"type":"object","description":"Present on graded products. Dark patterns are unlawful under EU DSA Art. 25 and enforced by the FTC; this makes the boundary machine-readable.","properties":{"score":{"type":"integer","minimum":0,"maximum":100},"band":{"type":"string","enum":["informative","persuasive","aggressive","deceptive"]},"regulatory_flags":{"type":"array","items":{"type":"object","properties":{"regulation":{"type":"string"},"jurisdiction":{"type":"string"},"concern":{"type":"string"}}}},"warning":{"type":["string","null"]}}},"PaymentRequired":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"maxAmountRequired":{"type":"string","description":"Atomic units. Equals the micro-USD price."},"resource":{"type":"string"},"payTo":{"type":"string"},"asset":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"}}}},"error":{"type":["string","null"]}}},"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"billed":{"type":"boolean","description":"Whether this request cost money. Almost always false."},"amount_billed":{"type":"integer"},"retryable":{"type":"boolean"},"retry_after_s":{"type":["integer","null"]},"request_id":{"type":"string"}}}}}}},"tags":[{"name":"psych"},{"name":"content"},{"name":"design"},{"name":"web"},{"name":"ref"},{"name":"legal"}]}