{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://crawlcheck.io/api/v1/schema","title":"CrawlCheck public API v1","description":"Response formats for /api/v1. Every field carries x-stability (stable | provisional | internal); what each level promises and the deprecation windows are in x-compatibility and at https://crawlcheck.io/docs/api/compatibility. Anything not listed here is not part of the contract. The unversioned /api/scan returns the internal record and may change without notice.","$defs":{"PublicReportV1":{"type":"object","additionalProperties":false,"required":["schema","version","id","domain","scanned_at","grade","overall","sections","findings","proof"],"properties":{"schema":{"type":"string","x-stability":"stable"},"version":{"const":"1.0","x-stability":"stable"},"id":{"type":["string","null"],"x-stability":"stable"},"domain":{"type":["string","null"],"x-stability":"stable"},"path":{"type":["string","null"],"x-stability":"stable"},"scanned_host":{"type":["string","null"],"x-stability":"stable"},"scanned_at":{"type":["string","null"],"x-stability":"stable"},"score_version":{"type":["number","null"],"x-stability":"stable"},"grade":{"type":["string","null"],"x-stability":"stable"},"overall":{"type":["number","null"],"x-stability":"stable"},"grade_detail":{"type":"object","properties":{"capped":{"type":"boolean","x-stability":"stable"},"cap":{"type":["string","null"],"x-stability":"stable"},"cap_reason":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"scanner_profile":{"type":"object","additionalProperties":false,"required":["version","scope","request_profile_sha256","attempted","responses_read","incomplete","outcomes"],"description":"Recorded initial identity comparison on this full scan, included in the report digest. An HTTP refusal can be a fully read response. Omitted on older or unmeasured reports.","properties":{"version":{"const":1,"x-stability":"stable"},"scope":{"const":"full_scan_initial_identity_comparison","x-stability":"stable"},"request_profile_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","x-stability":"stable"},"attempted":{"type":"integer","minimum":0,"x-stability":"stable"},"responses_read":{"type":"integer","minimum":0,"x-stability":"stable"},"incomplete":{"type":"integer","minimum":0,"x-stability":"stable"},"outcomes":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","crawler_token","http_status","state"],"properties":{"id":{"type":"string","x-stability":"stable"},"crawler_token":{"type":["string","null"],"x-stability":"stable"},"http_status":{"type":["integer","null"],"x-stability":"stable"},"state":{"enum":["response_read","incomplete"],"x-stability":"stable"}}},"x-stability":"stable"}},"x-stability":"stable"},"sections":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"x-stability":"stable"},"title":{"type":["string","null"],"x-stability":"stable"},"score":{"type":["number","null"],"description":"null means not measured, never zero","x-stability":"stable"}}},"x-stability":"stable"},"findings":{"type":"array","items":{"type":"object","properties":{"code":{"type":["string","null"],"x-stability":"stable"},"path":{"type":["string","null"],"x-stability":"stable"},"severity":{"type":["number","null"],"x-stability":"stable"},"title":{"type":["string","null"],"x-stability":"stable"},"detail":{"type":["string","null"],"x-stability":"stable"},"meaning":{"type":["string","null"],"x-stability":"stable"},"evidence":{"type":["string","null"],"maxLength":500,"x-stability":"stable"},"fid":{"type":["string","null"],"x-stability":"stable"},"decision_id":{"type":["string","null"],"x-stability":"stable"},"graph":{"type":["string","null"],"x-stability":"stable"},"locked":{"type":"boolean","description":"true on an unlicensed read for every finding but the top one: title, severity and path are present, the rest is withheld","x-stability":"stable"},"fingerprint":{"type":["string","null"],"description":"code|path; stable across scans of the same domain; null on a locked finding","x-stability":"stable"},"state":{"type":["string","null"],"enum":["new","persisted","worsened","improved","regressed","resolved","rule-changed",null],"description":"lifecycle on this scan; null when the domain has no stored history","x-stability":"provisional"},"first_seen":{"type":["string","null"],"x-stability":"provisional"},"scans_seen":{"type":["number","null"],"x-stability":"provisional"},"recurrences":{"type":["number","null"],"x-stability":"provisional"},"agent":{"type":["object","null"],"description":"for an agent acting on the finding: observation (what was seen) and interpretation (what CrawlCheck reads into it) kept apart; confidence (unconfirmed for a detector still on the advisory list at /accuracy); in_grade; severity_if_confirmed; remediation.text, remediation.automatic (true only for a defect with a mechanical fix; false when a person must decide) and remediation.needs_person (why). null on a locked finding","properties":{"observation":{"type":["string","null"],"x-stability":"stable"},"interpretation":{"type":["string","null"],"x-stability":"stable"},"confidence":{"type":["string","null"],"x-stability":"stable"},"in_grade":{"type":"boolean","x-stability":"stable"},"severity_if_confirmed":{"type":["number","null"],"x-stability":"stable"},"remediation":{"type":"object","properties":{"text":{"type":["string","null"],"x-stability":"stable"},"automatic":{"type":"boolean","x-stability":"stable"},"needs_person":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"}},"x-stability":"stable"},"valid_time":{"type":["object","null"],"description":"bitemporal: when the condition held on the site (valid_from / valid_to as after-by intervals between observations; null ends are unknown or still open) and when CrawlCheck recorded it (recorded_at, superseded_at)","x-stability":"provisional"}}},"x-stability":"stable"},"findings_withheld":{"type":["string","null"],"description":"Set on an unlicensed read: every finding is listed by title, severity and path; detail, evidence and code beyond the top one are withheld","x-stability":"stable"},"findings_summary":{"type":["object","null"],"properties":{"total":{"type":["number","null"],"x-stability":"stable"},"serious":{"type":["number","null"],"x-stability":"stable"},"by_severity":{"type":["object","null"],"x-stability":"provisional"}},"x-stability":"stable"},"provenance":{"type":["object","null"],"description":"Observer build, vantage, rule version, observed and stored times, sealed manifest","x-stability":"provisional"},"root_causes":{"type":["array","null"],"description":"Findings that share one cause or one fix, formed only from evidence in this record (e.g. robots.txt, the sitemap and llms.txt all answering with the site's HTML page). With a licence: cause, fix, generators, evidence and members. An unlicensed v1 read is built from the locked record, so the list is empty there; /api/v1/machine-record shows a group the top finding belongs to, by kind and size","x-stability":"provisional"},"fix_impact":{"type":["array","null"],"description":"One line per fix that would change this record (robots, sitemap, llms, entitymap, edge-bots, cache, page-code, chain, hsts, host-pair), best first: findings and rows it clears, the other fixes some of its rows also need, the score and letter after (the formula rerun), root causes it closes and certificate criteria it flips. Null on an unlicensed read; /api/impact has the names","x-stability":"provisional"},"score_ledger":{"type":["object","null"],"description":"combined {all_rows_fixed, all_findings_cleared, both} and next_letter {target, reachable, ...} are recomputed, never summed. What each decision moved. rows[]: every failing scored row with points = the score recomputed with that row passing minus the score now (same formula, Reach + 15 ceiling included), points_section_average, and why a row moves nothing; withheld (rows_withheld) where the fix list is. Findings move no points: each finding's score_effect states the letter cap it sets, whether it binds, and the letter without it.","x-stability":"provisional"},"confidence":{"type":["object","null"],"description":"Counts and ratios behind the reading: sections_scored, identities_answered, fetches_kept, stage_failures, non_observations, vantages. No composite number, because the parts do not combine into one honestly","x-stability":"provisional"},"bitemporal":{"type":["object","null"],"description":"Each stated fact with two times: when CrawlCheck observed it (observed_from, observed_last, removed_at) and when the site says it became true (valid time, null when the site does not say)","x-stability":"provisional"},"non_observations":{"type":["array","null"],"maxItems":80,"items":{"type":"object","properties":{"subject":{"type":["string","null"],"x-stability":"provisional"},"state":{"type":["string","null"],"x-stability":"provisional"},"reason":{"type":["string","null"],"x-stability":"provisional"},"attempted":{"type":["boolean","null"],"x-stability":"provisional"}}},"description":"What was not measured on this scan and why; an unmeasured subject is never scored as a pass or a fail","x-stability":"provisional"},"fact_lineage":{"type":["object","null"],"description":"Each value carries locators[] (one per source): bytes [start, end) in the page this scan received, line, col, scope (meta[og:title], script[ld+json]#0, title, page text) and match (value | property | normalised | partial), or {found:false, why}; check them with /api/locate. Each business fact (name, phone, address, email, founder) with every value the site stated and where it stated it, and whether the statements agree","x-stability":"provisional"},"checks":{"type":"array","items":{"type":"object","properties":{"path":{"type":["string","null"],"x-stability":"stable"},"status":{"type":["number","null"],"x-stability":"stable"},"bytes":{"type":["number","null"],"x-stability":"stable"}}},"x-stability":"stable"},"agentview":{"type":"array","items":{"type":"object","properties":{"label":{"type":["string","null"],"x-stability":"provisional"},"status":{"type":["number","null"],"x-stability":"provisional"},"words":{"type":["number","null"],"x-stability":"provisional"}}},"x-stability":"provisional"},"nap":{"type":["object","null"],"x-stability":"internal"},"headroom":{"type":["object","null"],"properties":{"gain":{"type":["number","null"],"x-stability":"internal"},"failing":{"type":["number","null"],"x-stability":"internal"}},"x-stability":"internal"},"history":{"type":"array","items":{"type":"object","properties":{"at":{"type":["string","null"],"x-stability":"stable"},"overall":{"type":["number","null"],"x-stability":"stable"},"score_version":{"type":["number","null"],"x-stability":"stable"}}},"x-stability":"stable"},"proof":{"type":"object","properties":{"digest":{"type":["string","null"],"x-stability":"stable"},"algorithm":{"type":["string","null"],"x-stability":"stable"},"anchored":{"type":["string","null"],"x-stability":"stable"},"verify":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"links":{"type":"object","x-stability":"provisional"}},"x-stability":"stable","examples":[{"schema":"https://crawlcheck.io/api/v1/schema#PublicReportV1","version":"1.0","id":"qw0tlfel5v","domain":"crawlcheck.io","path":"/","scanned_host":"crawlcheck.io","scanned_at":"2026-10-01T00:47:22.513Z","score_version":26,"grade":"A","overall":98,"grade_detail":{"capped":false,"cap":null,"cap_reason":null},"sections":[{}],"findings":[],"findings_withheld":null,"score_ledger":{"score":98,"letter":"A","cap":null,"capped":false,"held_at_reach":false,"matches_record":true,"rows":[],"rows_withheld":3,"method":"Points per row: the score recomputed with that one row passing, minus the score…"},"findings_summary":null,"provenance":{"v":1,"observer":"crawlcheck-primary","observer_release":"2026-10-01","vantage":{},"rulepack":"sv26","audit_version":4,"meg_v":3,"scope":"full","observed_at":"2026-10-01T00:47:22.513Z","stored_at":"2026-10-01T00:47:38.932Z","artifacts":"manifest:3a3c742064416f0031b4cfefc494f7939adf2e36a606d68440421f998d9bc0d4","findings":0,"decisions":0,"manifest_signature":{}},"confidence":{"v":1,"sections_scored":{},"identities_answered":{},"fetches_kept":{},"stage_failures":0,"non_observations":6,"non_observations_attempted":2,"vantages":1,"refused":false,"note":"counts and ratios only - there is no composite confidence number, because the p…"},"bitemporal":{"v":1,"recorded_at":"2026-10-01T00:47:22.513Z","axes":{},"facts":[]},"non_observations":[{}],"checks":[{}],"agentview":[{}],"nap":{"phones":[],"addresses":[],"citations":[],"verified":[],"hours":[],"conflicts":{},"lineage":{}},"fact_lineage":{"v":1,"scored":false,"facts":[],"disagree":[],"single_source":[],"subject":{},"read":{}},"headroom":{"gain":2,"failing":3},"history":[{}],"proof":{"digest":"0c329e45045d659a4ec3dbe4584ac17f01ee82735467f8cde2856493079825b8","algorithm":"sha256 over the canonical measurement subject described at https://crawlcheck.i…","anchored":"daily, OpenTimestamps to Bitcoin","verify":"https://crawlcheck.io/proof"},"links":{"report":"https://crawlcheck.io/r/qw0tlfel5v","graph":"https://crawlcheck.io/api/graph/qw0tlfel5v","raw":"https://crawlcheck.io/r/qw0tlfel5v.raw.json","schema":"https://crawlcheck.io/api/v1/schema","docs":"https://crawlcheck.io/docs/api#api-v-scan"}}]},"MachineRecordV1":{"type":"object","required":["kind","version","subject","observation","findings","capabilities","evidence","access"],"description":"One observation in one shape (GET /api/v1/machine-record, MCP machine_record): subject, observation, findings (top in full without a licence; the rest locked), capabilities with safety class and verification state, evidence roots and verifier links","properties":{"kind":{"const":"crawlcheck-machine-record","x-stability":"stable"},"version":{"type":"string","x-stability":"stable"},"subject":{"type":"object","x-stability":"provisional"},"observation":{"type":"object","x-stability":"provisional"},"findings":{"type":"array","description":"each open finding carries trust {freshness, confidence {level, means, basis[]}, contradictions[]}","x-stability":"provisional"},"freshness":{"type":"object","description":"observed_at, age_hours, latest_report_id, is_latest, newer_scan_exists, last_second_reading_at","x-stability":"provisional"},"fix_impact":{"type":["array","object","null"],"description":"With a licence: one line per fix that would change this record, best first (findings and rows it clears, other fixes some rows also need, score and letter after, root causes closed, certificate criteria flipped). Without: {fixes_available, best_single_fix {letter_after, score_after, findings_cleared, rows_cleared}} and no names","x-stability":"provisional"},"score_ledger":{"type":["object","null"],"description":"score, letter, cap and the points each failing row moves (rows open with a licence); each open finding carries score_effect {points: 0, cap, binding, letter_without_it, says}","x-stability":"provisional"},"confidence":{"type":"object","description":"counts and ratios plus vantages; no composite number; levels: contested | cross_vantage_confirmed | reproduced | single_reading","x-stability":"provisional"},"contradictions":{"type":"object","description":"site (the site contradicts itself) and between_networks_open (observers disagree), for findings this caller can open","x-stability":"provisional"},"findings_summary":{"type":["object","null"],"x-stability":"provisional"},"findings_withheld":{"type":["string","null"],"x-stability":"provisional"},"capabilities":{"type":"object","x-stability":"provisional"},"evidence":{"type":"object","x-stability":"provisional"},"access":{"type":"object","x-stability":"provisional"}},"x-stability":"provisional","examples":[{"schema":"https://crawlcheck.io/api/v1/schema#MachineRecordV1","version":"1.0","kind":"crawlcheck-machine-record","subject":{"domain":"wikipedia.org","host":"www.wikipedia.org","path":"/","report_id":"evuew4dyje","scanned_at":"2026-10-01T00:47:02.058Z","score_version":26},"observation":{"grade":"D","overall":53,"refused":false,"unscored_reason":null,"trace_id":"0fc371afddbba3d58a9555fb798968c6","observer":{},"identity_basis":"every identity was sent by CrawlCheck from its own network; none is the named o…"},"findings":[{}],"findings_summary":{"total":5,"serious":1,"by_severity":{}},"findings_withheld":"Every finding is listed by title, severity and path. The top one carries its co…","capabilities":{"observed":true,"sources":[],"declared":0,"by_safety_class":{},"by_verification":{},"verified":[],"mismatches":[],"verification":null,"items":[],"reading":"verified means CrawlCheck called it and the response matched what the site decl…"},"observers":{"registry":"https://crawlcheck.io/.well-known/crawlcheck-observers.json","count_for_this_domain":2,"side_by_side":{}},"freshness":{"observed_at":"2026-10-01T00:47:02.058Z","age_hours":0,"latest_report_id":"evuew4dyje","is_latest":true,"newer_scan_exists":false,"last_second_reading_at":"2026-09-30T15:55:13.473Z","note":"observed_at is when CrawlCheck fetched the site; nothing here says the site is …"},"confidence":{"v":1,"sections_scored":{},"identities_answered":{},"fetches_kept":{},"stage_failures":0,"non_observations":14,"non_observations_attempted":8,"vantages":1,"refused":false,"note":"counts and ratios only - there is no composite confidence number, because the p…","vantages_note":"CrawlCheck’s network plus every independent observer that read this URL within …","levels":{}},"contradictions":{"site":[],"between_networks_open":[],"locked_findings_not_shown":4},"evidence":{"manifest_sha256":"9bc892a9b74d9a116e5cc5bd992a7f71a28679d1508e91bf1d8cad2397c5be4a","manifest_version":3,"signed":true,"signing_kid":"hcIAczGf-8EFBnkunmZlvFWnD2nHHeHeC9cM4BTiBVo","roots":{},"experiences":22,"verify":"https://crawlcheck.io/api/verify?id=evuew4dyje","bundle":"https://crawlcheck.io/api/bundle?id=evuew4dyje","offline_verifier":"https://crawlcheck.io/crawlcheck-verify.mjs","prov":null},"score_ledger":{"score":53,"letter":"D","cap":"C","capped":false,"held_at_reach":false,"matches_record":true,"rows":[],"rows_withheld":26,"method":"Points per row: the score recomputed with that one row passing, minus the score…"},"access":{"level":"public","rule":"the top finding in full; the rest by title, severity and path (a licence for th…"}}]},"ErrorV1":{"type":"object","required":["error"],"description":"The error envelope; every code and the rules at /spec/considerations.","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","x-stability":"stable"},"status":{"type":"integer","x-stability":"stable"},"message":{"type":"string","x-stability":"stable"}},"x-stability":"stable"},"error_code":{"type":"string","description":"stable machine code; on every unsigned error answer","x-stability":"stable"},"retryable":{"type":"boolean","x-stability":"stable"},"trace_id":{"type":"string","x-stability":"stable"},"span_id":{"type":"string","x-stability":"stable"}},"x-stability":"stable"},"EvidenceBundleV1":{"type":"object","additionalProperties":false,"required":["kind","version","report","verifier","manifest","record","seal"],"description":"GET /api/bundle: one file that checks offline with /crawlcheck-verify.mjs. A field that cannot be filled (an anonymous download, an unsealed day, a record from before manifests) is null with a *_withheld / *_missing / why reason, never omitted","properties":{"kind":{"const":"crawlcheck-evidence-bundle","x-stability":"stable"},"version":{"type":"integer","x-stability":"stable"},"generated_at":{"type":"string","x-stability":"stable"},"report":{"type":"object","required":["id","domain","scanned_at"],"properties":{"id":{"type":["string","null"],"x-stability":"stable"},"domain":{"type":["string","null"],"x-stability":"stable"},"path":{"type":["string","null"],"x-stability":"stable"},"scanned_at":{"type":["string","null"],"x-stability":"stable"},"score_version":{"type":["number","null"],"x-stability":"stable"},"archived":{"type":"boolean","x-stability":"stable"}},"x-stability":"stable"},"verifier":{"type":"object","required":["url","sha256"],"properties":{"url":{"type":"string","x-stability":"stable"},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","x-stability":"stable"},"run":{"type":"string","x-stability":"stable"},"page":{"type":"string","x-stability":"stable"}},"x-stability":"stable"},"proves":{"type":"array","items":{"type":"string"},"x-stability":"provisional"},"does_not_prove":{"type":"array","items":{"type":"string"},"x-stability":"provisional"},"manifest":{"type":["object","null"],"required":["sha256","body"],"properties":{"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","x-stability":"stable"},"body":{"type":["string","null"],"x-stability":"stable"},"body_missing":{"type":["string","null"],"x-stability":"stable"},"signature":{"type":["object","null"],"properties":{"alg":{"type":["string","null"],"x-stability":"stable"},"kid":{"type":["string","null"],"x-stability":"stable"},"message":{"type":["string","null"],"x-stability":"stable"},"sig":{"type":["string","null"],"x-stability":"stable"},"signed_at":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"key":{"type":["object","null"],"properties":{"jwk":{"type":"object","required":["kty","crv","x"],"properties":{"kty":{"const":"OKP","x-stability":"stable"},"crv":{"const":"Ed25519","x-stability":"stable"},"x":{"type":"string","x-stability":"stable"}},"x-stability":"stable"},"kid":{"type":"string","x-stability":"stable"},"published_in":{"type":"string","x-stability":"stable"}},"x-stability":"stable"},"key_missing":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"record":{"type":["object","null"],"required":["digest","subject"],"properties":{"digest":{"type":["string","null"],"x-stability":"stable"},"subject":{"type":["string","null"],"x-stability":"stable"},"subject_withheld":{"type":["string","null"],"x-stability":"stable"},"recipe":{"type":["string","null"],"x-stability":"internal"},"decision_leaves":{"type":["array","null"],"items":{"type":"object"},"x-stability":"stable"},"lineage_leaves":{"type":["array","null"],"items":{"type":"object"},"x-stability":"stable"},"leaves_withheld":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"seal":{"type":["object","null"],"required":["state"],"properties":{"state":{"enum":["sealed","pending","unsealed","unverifiable","unknown"],"x-stability":"stable"},"day":{"type":["string","null"],"x-stability":"stable"},"root":{"type":["string","null"],"x-stability":"stable"},"path":{"type":"array","items":{"type":"object","required":["side","hash"],"properties":{"side":{"enum":["left","right"],"x-stability":"stable"},"hash":{"type":"string","pattern":"^[0-9a-f]{64}$","x-stability":"stable"}}},"x-stability":"stable"},"leaves_that_day":{"type":["number","null"],"x-stability":"stable"},"sealed_at":{"type":["string","null"],"x-stability":"stable"},"calendars":{"type":"array","items":{"type":"string"},"x-stability":"stable"},"ots_base64":{"type":["string","null"],"x-stability":"stable"},"bitcoin_block":{"type":["number","null"],"x-stability":"stable"},"recipe":{"type":["string","null"],"x-stability":"internal"},"why":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"publish_guard":{"type":"object","description":"Every bundle is scanned before it is served; a section that matched is null and carries <section>_withheld","properties":{"checked":{"type":"array","items":{"type":"string"},"x-stability":"provisional"},"withheld":{"type":"array","items":{"type":"object","properties":{"section":{"type":"string","x-stability":"provisional"},"matched":{"type":"array","items":{"type":"string"},"x-stability":"provisional"}}},"x-stability":"provisional"}},"x-stability":"provisional"},"disclosure":{"type":"string","description":"Who can read which representation of a scan: /docs/api#disclosure","x-stability":"provisional"}},"patternProperties":{"^[a-z_]+_withheld$":{"type":"string"}},"x-stability":"stable"},"RemediationReceiptV1":{"type":"object","additionalProperties":false,"required":["receipt_id","kind","v","issued_at","issuer","subject","before","declared_fix","deployed","after","verification","signature"],"description":"A signed remediation receipt (GET /api/receipt?id=). receipt_id = rc1: + sha256 of the canonical JSON of every field except receipt_id and signature; signature = Ed25519 over 'crawlcheck-receipt-v1\\n' + that sha256","properties":{"receipt_id":{"type":"string","pattern":"^rc1:[0-9a-f]{64}$","x-stability":"stable"},"kind":{"const":"crawlcheck-remediation-receipt","x-stability":"stable"},"v":{"const":1,"x-stability":"stable"},"issued_at":{"type":"string","x-stability":"stable"},"issuer":{"type":"object","required":["key"],"properties":{"observer":{"type":["string","null"],"x-stability":"stable"},"version_id":{"type":["string","null"],"x-stability":"stable"},"version_tag":{"type":["string","null"],"x-stability":"stable"},"key":{"type":"object","required":["kid","jwk"],"properties":{"kid":{"type":"string","x-stability":"stable"},"jwk":{"type":"object","x-stability":"stable"},"published_in":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"}},"x-stability":"stable"},"subject":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","x-stability":"stable"}},"x-stability":"stable"},"before":{"$ref":"#/$defs/ReceiptSideV1","x-stability":"stable"},"after":{"$ref":"#/$defs/ReceiptSideV1","x-stability":"stable"},"declared_fix":{"type":"object","properties":{"kind":{"type":"string","x-stability":"stable"},"declared_by":{"type":["string","null"],"x-stability":"stable"},"declared_at":{"type":["string","null"],"x-stability":"stable"},"plugin_version":{"type":["string","null"],"x-stability":"stable"},"fixes":{"type":["array","null"],"items":{"type":"string"},"x-stability":"stable"},"note":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"deployed":{"type":"object","properties":{"at":{"type":["string","null"],"x-stability":"stable"},"basis":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"verification":{"type":"object","required":["verdict"],"properties":{"verdict":{"enum":["improved","unchanged","mixed","regressed"],"x-stability":"stable"},"summary":{"type":["string","null"],"x-stability":"stable"},"comparable":{"type":"boolean","x-stability":"stable"},"findings":{"type":"object","x-stability":"provisional"},"rows":{"type":"object","x-stability":"provisional"},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","x-stability":"stable"},"state":{"type":"string","x-stability":"stable"},"before_sha256":{"type":["string","null"],"x-stability":"stable"},"after_sha256":{"type":["string","null"],"x-stability":"stable"},"before_status":{"type":["number","null"],"x-stability":"stable"},"after_status":{"type":["number","null"],"x-stability":"stable"}}},"x-stability":"stable"},"rollback_needed":{"type":"boolean","x-stability":"stable"},"rollback_steps":{"type":"array","items":{"type":"object"},"x-stability":"provisional"},"method":{"type":["string","null"],"x-stability":"internal"}},"x-stability":"stable"},"links":{"type":"object","x-stability":"provisional"},"signature":{"type":"object","required":["alg","kid","receipt_sha256","message","sig"],"properties":{"v":{"type":["number","null"],"x-stability":"stable"},"alg":{"const":"Ed25519","x-stability":"stable"},"kid":{"type":"string","x-stability":"stable"},"over":{"type":["string","null"],"x-stability":"stable"},"receipt_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","x-stability":"stable"},"message":{"type":"string","x-stability":"stable"},"sig":{"type":"string","x-stability":"stable"},"signed_at":{"type":["string","null"],"x-stability":"stable"},"canonical":{"type":["string","null"],"x-stability":"internal"}},"x-stability":"stable"}},"x-stability":"stable"},"TraceV1":{"type":"object","required":["id","traced"],"description":"One scan's trace (GET /api/trace?id=, owner; sampled by the trace CI job). W3C Trace Context ids. Every span's parent is the scan span (root_span_id) or a span of this trace; the scan span's own parent is the caller's span when the scan joined a caller's trace (parent).","allOf":[{"if":{"properties":{"traced":{"const":true}}},"then":{"required":["trace_id","root_span_id","traceparent","spans","dropped"]}}],"properties":{"id":{"type":["string","null"],"x-stability":"provisional"},"domain":{"type":["string","null"],"x-stability":"provisional"},"scanned_at":{"type":["string","null"],"x-stability":"provisional"},"traced":{"type":"boolean","x-stability":"provisional"},"why":{"type":["string","null"],"x-stability":"provisional"},"trace_id":{"type":"string","pattern":"^[0-9a-f]{32}$","x-stability":"provisional"},"root_span_id":{"type":"string","pattern":"^[0-9a-f]{16}$","x-stability":"provisional"},"traceparent":{"type":"string","pattern":"^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","x-stability":"provisional"},"parent":{"type":["object","null"],"properties":{"span_id":{"type":"string","pattern":"^[0-9a-f]{16}$","x-stability":"provisional"},"source":{"type":["string","null"],"x-stability":"provisional"},"previous_trace_id":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"scan_id":{"type":["string","null"],"x-stability":"provisional"},"started_at":{"type":["string","null"],"x-stability":"provisional"},"total_ms":{"type":["number","null"],"x-stability":"provisional"},"dropped":{"type":"integer","minimum":0,"x-stability":"provisional"},"recorded_through":{"x-stability":"provisional"},"spans":{"type":"array","items":{"$ref":"#/$defs/SpanV1"},"x-stability":"provisional"},"errors":{"type":"array","items":{"type":"object","required":["span_id"],"properties":{"error_id":{"type":["string","null"],"x-stability":"provisional"},"stage":{"type":["string","null"],"x-stability":"provisional"},"span_id":{"type":["string","null"],"pattern":"^[0-9a-f]{16}$","x-stability":"provisional"},"error":{"type":["string","null"],"x-stability":"provisional"}}},"x-stability":"provisional"},"findings":{"type":"array","items":{"type":"object","properties":{"code":{"type":["string","null"],"x-stability":"provisional"},"decision_id":{"type":["string","null"],"x-stability":"provisional"},"span_id":{"type":["string","null"],"pattern":"^[0-9a-f]{16}$","x-stability":"provisional"},"parent_span_id":{"type":["string","null"],"x-stability":"provisional"},"parent_stage":{"type":["string","null"],"x-stability":"provisional"},"reads":{"type":["number","null"],"x-stability":"provisional"}}},"x-stability":"provisional"},"coverage":{"type":"object","x-stability":"provisional"},"slowest":{"type":"array","x-stability":"provisional"},"decisions_with_spans":{"type":["number","null"],"x-stability":"provisional"},"note":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"SpanV1":{"type":"object","required":["span_id","parent_span_id","stage","start_ms","status"],"description":"One span: a stage of the scan, or (kind rule) one decision, started when its rule decided.","properties":{"span_id":{"type":"string","pattern":"^[0-9a-f]{16}$","x-stability":"provisional"},"parent_span_id":{"type":"string","pattern":"^[0-9a-f]{16}$","x-stability":"provisional"},"stage":{"type":"string","minLength":1,"x-stability":"provisional"},"kind":{"enum":["rule"],"x-stability":"provisional"},"start_ms":{"type":"number","minimum":0,"x-stability":"provisional"},"dur_ms":{"type":["number","null"],"minimum":0,"x-stability":"provisional"},"status":{"enum":["ok","error","inputs_disputed"],"x-stability":"provisional"},"error_id":{"type":["string","null"],"x-stability":"provisional"},"code":{"type":["string","null"],"x-stability":"provisional"},"path":{"type":["string","null"],"x-stability":"provisional"},"decision_id":{"type":["string","null"],"x-stability":"provisional"},"reads":{"type":"array","items":{"type":"object","properties":{"experience_id":{"type":["string","null"],"x-stability":"provisional"},"fetched_in":{"type":["string","null"],"x-stability":"provisional"},"stage":{"type":["string","null"],"x-stability":"provisional"},"fetched_after_rule":{"type":"boolean","x-stability":"provisional"}}},"x-stability":"provisional"},"parent_basis":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"DisputeResolutionV1":{"type":"object","required":["resolution_id","kind","v","dispute_id","issued_at","issuer","subject","dispute","remeasurement","decision","signature"],"description":"dsp1: a signed resolution of a dispute against one finding (GET /api/disputes/resolution?id=). Verifies offline with crawlcheck-verify.mjs: hash, key id, Ed25519 signature, and the verdict re-derived from the recorded readings by the published decision table.","properties":{"resolution_id":{"type":"string","pattern":"^dr1:[0-9a-f]{64}$","x-stability":"provisional"},"kind":{"const":"crawlcheck-dispute-resolution","x-stability":"provisional"},"v":{"const":1,"x-stability":"provisional"},"schema":{"type":["string","null"],"x-stability":"provisional"},"dispute_id":{"type":"string","pattern":"^dsp1:[0-9a-f]{24}$","x-stability":"provisional"},"issued_at":{"type":"string","x-stability":"provisional"},"issuer":{"type":"object","properties":{"observer":{"type":["string","null"],"x-stability":"provisional"},"version_id":{"type":["string","null"],"x-stability":"provisional"},"version_tag":{"type":["string","null"],"x-stability":"provisional"},"key":{"type":"object","properties":{"kid":{"type":"string","x-stability":"provisional"},"jwk":{"type":"object","x-stability":"provisional"},"published_in":{"type":"string","x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"subject":{"type":"object","required":["domain","record","finding"],"properties":{"domain":{"type":"string","x-stability":"provisional"},"record":{"type":"object","x-stability":"provisional"},"finding":{"type":"object","properties":{"code":{"type":"string","x-stability":"provisional"},"path":{"type":["string","null"],"x-stability":"provisional"},"fid":{"type":["string","null"],"x-stability":"provisional"},"decision_id":{"type":["string","null"],"x-stability":"provisional"},"title":{"type":["string","null"],"x-stability":"provisional"},"severity":{"type":["number","null"],"x-stability":"provisional"},"rule_revision":{"type":["number","null"],"x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"dispute":{"type":"object","properties":{"filed_at":{"type":"string","x-stability":"provisional"},"ground":{"enum":["misread","fixed","network","rule"],"x-stability":"provisional"},"ground_text":{"type":["string","null"],"x-stability":"provisional"},"statement":{"type":"string","x-stability":"provisional"},"ownership":{"type":["object","null"],"properties":{"method":{"type":"string","x-stability":"provisional"},"at":{"type":"string","x-stability":"provisional"},"url":{"type":["string","null"],"x-stability":"provisional"},"sha256":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"remeasurement":{"type":"object","required":["replay","observers"],"properties":{"replay":{"type":"object","properties":{"reproduces":{"type":["boolean","null"],"x-stability":"provisional"},"rule":{"type":["string","null"],"x-stability":"provisional"},"read":{"x-stability":"provisional"},"why":{"type":["string","null"],"x-stability":"provisional"},"rule_revision":{"type":["number","null"],"x-stability":"provisional"},"over":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"observers":{"type":"array","items":{"type":"object","required":["role","observer_id","finding_present"],"properties":{"role":{"enum":["primary","independent"],"x-stability":"provisional"},"observer_id":{"type":"string","x-stability":"provisional"},"network_class":{"type":["string","null"],"x-stability":"provisional"},"network":{"type":["string","null"],"x-stability":"provisional"},"at":{"type":["string","null"],"x-stability":"provisional"},"finding_present":{"type":["boolean","null"],"x-stability":"provisional"},"inputs_agree":{"type":["boolean","null"],"x-stability":"provisional"},"method":{"type":["string","null"],"x-stability":"provisional"},"reading":{"type":["string","null"],"x-stability":"provisional"},"side":{"type":["object","null"],"x-stability":"provisional"},"observation":{"type":["object","null"],"x-stability":"provisional"}}},"x-stability":"provisional"},"deadline":{"type":["string","null"],"x-stability":"provisional"},"independent_wait_hours":{"type":["number","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"decision":{"type":"object","required":["verdict","effect"],"properties":{"verdict":{"enum":["upheld","corrected","fixed_since","vantage_dependent","no_longer_observed","inconclusive"],"x-stability":"provisional"},"verdict_text":{"type":["string","null"],"x-stability":"provisional"},"effect":{"enum":["stands","withdrawn","stands_for_record","stands_with_scope","stands_unresolved"],"x-stability":"provisional"},"effect_text":{"type":["string","null"],"x-stability":"provisional"},"rule":{"type":["string","null"],"x-stability":"provisional"},"table":{"type":["string","null"],"x-stability":"provisional"},"derived_by":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"links":{"type":"object","x-stability":"provisional"},"signature":{"type":"object","required":["alg","kid","resolution_sha256","message","sig"],"properties":{"v":{"const":1,"x-stability":"provisional"},"alg":{"const":"Ed25519","x-stability":"provisional"},"kid":{"type":"string","x-stability":"provisional"},"over":{"const":"resolution_sha256","x-stability":"provisional"},"resolution_sha256":{"type":"string","x-stability":"provisional"},"message":{"type":"string","x-stability":"provisional"},"sig":{"type":"string","x-stability":"provisional"},"signed_at":{"type":"string","x-stability":"provisional"},"canonical":{"type":"string","x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"RulebookV1":{"type":"object","required":["kind","v","generated_at","counts","severity_scale","rules"],"description":"Every finding CrawlCheck can raise (GET /api/rules): what it means, its level, its fix and its share of counted scans.","properties":{"ok":{"type":"boolean","x-stability":"provisional"},"kind":{"const":"crawlcheck-rulebook","x-stability":"provisional"},"v":{"const":1,"x-stability":"provisional"},"generated_at":{"type":"string","x-stability":"provisional"},"score_version":{"type":["number","null"],"x-stability":"provisional"},"schema":{"type":["string","null"],"x-stability":"provisional"},"counts":{"type":"object","required":["rules"],"properties":{"rules":{"type":"integer","x-stability":"provisional"},"by_kind":{"type":"object","additionalProperties":{"type":"integer"},"x-stability":"provisional"},"by_family":{"type":"object","additionalProperties":{"type":"integer"},"x-stability":"provisional"},"revised":{"type":"integer","x-stability":"provisional"},"scored":{"type":"integer","x-stability":"provisional"}},"x-stability":"provisional"},"scans_counted":{"type":["integer","null"],"x-stability":"provisional"},"severity_scale":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","x-stability":"provisional"}}},"x-stability":"provisional"},"method":{"type":"object","properties":{"revisions":{"type":["string","null"],"x-stability":"provisional"},"share":{"type":["string","null"],"x-stability":"provisional"},"grade":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"rules":{"type":"array","items":{"$ref":"#/$defs/RuleV1"},"description":"every rule; with ?code= only that rule (counts still describe the whole rulebook)","x-stability":"provisional"},"filter":{"type":["object","null"],"properties":{"code":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"RuleV1":{"type":"object","required":["code","kind","family","title","severity","revision","share_of_scans"],"description":"One rule: the code, what it means, its level, its current revision, its fix and its share of counted scans.","properties":{"code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]+$","x-stability":"provisional"},"kind":{"enum":["scan","answer_correlation","capability_mismatch","self_audit"],"description":"self_audit: a defect in CrawlCheck's own record, never in the site","x-stability":"provisional"},"family":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","x-stability":"provisional"},"label":{"type":"string","x-stability":"provisional"}},"x-stability":"provisional"},"title":{"type":["string","null"],"x-stability":"provisional"},"meaning":{"type":["string","null"],"x-stability":"provisional"},"severity":{"type":"object","properties":{"level":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"scored":{"type":"boolean","description":"raised on a graded scan record; refusals, answer runs, capability mismatches and self-audit findings are not","x-stability":"provisional"},"measured_on":{"type":["string","null"],"x-stability":"provisional"},"revision":{"type":"object","required":["current"],"properties":{"current":{"type":"integer","minimum":1,"x-stability":"provisional"},"revised_at":{"type":["string","null"],"description":"when the current revision took effect; null while the rule is at revision 1","x-stability":"provisional"}},"x-stability":"provisional"},"fix":{"type":"object","properties":{"advice":{"type":["string","null"],"x-stability":"provisional"},"effort":{"type":["string","null"],"x-stability":"provisional"},"endpoint":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"share_of_scans":{"type":"object","required":["pct","basis"],"properties":{"pct":{"type":["number","null"],"x-stability":"provisional"},"scans":{"type":["integer","null"],"x-stability":"provisional"},"of_scans":{"type":["integer","null"],"x-stability":"provisional"},"basis":{"type":"string","x-stability":"provisional"}},"x-stability":"provisional"},"links":{"type":"object","properties":{"self":{"type":["string","null"],"x-stability":"provisional"},"api":{"type":["string","null"],"x-stability":"provisional"},"glossary":{"type":"array","items":{"type":"string"},"x-stability":"provisional"},"workflow":{"type":["string","null"],"x-stability":"provisional"},"lineage":{"type":["string","null"],"x-stability":"provisional"},"explain_template":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"FixOutcomesV1":{"type":"object","required":["kind","v","receipt","window","connected","usable","series","not_proof"],"description":"What the owner's connected outcome sources counted either side of a receipt's anchor day (GET /api/outcomes). One series per named source; per-day values compared; a series with no source is connected:false with how_to_connect; a window under 7 measured days is usable:false with why. Never a claim of cause.","properties":{"ok":{"type":"boolean","x-stability":"provisional"},"kind":{"const":"crawlcheck-fix-outcomes","x-stability":"provisional"},"v":{"const":1,"x-stability":"provisional"},"generated_at":{"type":"string","x-stability":"provisional"},"cached":{"type":"boolean","x-stability":"provisional"},"receipt":{"type":"object","required":["id","domain","anchor"],"properties":{"id":{"type":"string","pattern":"^rc1:[0-9a-f]{64}$","x-stability":"provisional"},"domain":{"type":"string","x-stability":"provisional"},"verdict":{"type":["string","null"],"x-stability":"provisional"},"findings_cleared":{"type":"array","items":{"type":"string"},"x-stability":"provisional"},"url":{"type":"string","x-stability":"provisional"},"anchor":{"type":"object","required":["day","basis"],"properties":{"at":{"type":"string","x-stability":"provisional"},"day":{"type":"string","format":"date","x-stability":"provisional"},"basis":{"type":"string","x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"window":{"type":"object","required":["days","before","after"],"properties":{"days":{"type":"integer","minimum":7,"maximum":90,"x-stability":"provisional"},"before":{"type":"object","properties":{"from":{"type":["string","null"],"x-stability":"provisional"},"to":{"type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"after":{"type":"object","properties":{"from":{"type":["string","null"],"x-stability":"provisional"},"to":{"type":["string","null"],"x-stability":"provisional"},"days_elapsed":{"type":"integer","x-stability":"provisional"},"complete":{"type":"boolean","x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"provisional"},"connected":{"type":"integer","x-stability":"provisional"},"usable":{"type":"integer","x-stability":"provisional"},"series":{"type":"array","items":{"type":"object","required":["key","label","source","mode","connected","usable","why"],"properties":{"key":{"type":"string","x-stability":"provisional"},"label":{"type":"string","x-stability":"provisional"},"source":{"type":"string","x-stability":"provisional"},"mode":{"enum":["daily","events"],"x-stability":"provisional"},"connected":{"type":"boolean","x-stability":"provisional"},"note":{"type":"string","x-stability":"provisional"},"how_to_connect":{"type":["string","null"],"x-stability":"provisional"},"before":{"anyOf":[{"$ref":"#/$defs/OutcomeSideV1"},{"type":"null"}],"x-stability":"provisional"},"after":{"anyOf":[{"$ref":"#/$defs/OutcomeSideV1"},{"type":"null"}],"x-stability":"provisional"},"delta_per_day":{"type":["number","null"],"x-stability":"provisional"},"pct":{"type":["number","null"],"x-stability":"provisional"},"usable":{"type":"boolean","x-stability":"provisional"},"why":{"type":"string","x-stability":"provisional"}}},"x-stability":"provisional"},"not_measured":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","x-stability":"provisional"},"why":{"type":"string","x-stability":"provisional"}}},"x-stability":"provisional"},"summary":{"type":"string","x-stability":"provisional"},"reading":{"type":"string","x-stability":"provisional"},"not_proof":{"type":"string","x-stability":"provisional"},"how_to_cite":{"type":"string","x-stability":"provisional"}},"x-stability":"provisional"},"OutcomeSideV1":{"type":"object","required":["days","measured","sum","per_day"],"properties":{"from":{"type":["string","null"],"x-stability":"provisional"},"to":{"type":["string","null"],"x-stability":"provisional"},"days":{"type":"integer","x-stability":"provisional"},"measured":{"type":"integer","x-stability":"provisional"},"sum":{"type":"number","x-stability":"provisional"},"per_day":{"type":["number","null"],"x-stability":"provisional"}},"x-stability":"provisional"},"ReceiptSideV1":{"type":"object","required":["report_id","scanned_at"],"properties":{"report_id":{"type":["string","null"],"x-stability":"stable"},"scanned_at":{"type":["string","null"],"x-stability":"stable"},"grade":{"type":["string","null"],"x-stability":"stable"},"score":{"type":["number","null"],"x-stability":"stable"},"score_version":{"type":["number","null"],"x-stability":"stable"},"refused":{"type":"boolean","x-stability":"stable"},"findings":{"type":["number","null"],"x-stability":"stable"},"manifest_sha256":{"type":["string","null"],"x-stability":"stable"},"decision_root":{"type":["string","null"],"x-stability":"stable"},"trace_id":{"type":["string","null"],"x-stability":"stable"}},"x-stability":"stable"},"MachineExperienceRecordV1":{"title":"CrawlCheck Machine Experience Record (sealed scan manifest)","description":"What one CrawlCheck scan fetched: every request it sent, as which identity, from which network, with which headers, what came back (status, content type, byte count, SHA-256) and whether the bytes were kept. The manifest is serialised as canonical JSON (object keys sorted, no whitespace, strings and numbers as JSON.stringify writes them). manifest_sha256 is the SHA-256 of exactly those bytes and is the key under which the bytes are served: https://crawlcheck.io/api/artifact/<manifest_sha256>?body=1. The digest and the signature are not inside the bytes they cover; they travel beside the manifest in the scan record (meg.manifest_sha256, meg.signature - see $defs/ManifestSignatureV1). To verify: fetch the body, SHA-256 it, compare with the key; then check the Ed25519 signature over \"crawlcheck-meg-manifest-v1\\n\" + manifest_sha256 against the key with that kid in https://crawlcheck.io/.well-known/http-message-signatures-directory. Versions: 1 (2026-09-20, first hours) stored states decided before the write; 2 every stored state is what the artifact store confirmed before sealing; 3 adds roots, Merkle roots over the experiences, the decisions and the extracted business facts. Validated against v2 and v3 manifests; no v1 manifest was in the sample.","type":"object","additionalProperties":false,"required":["v","scanned_at","recorded_at","observer","identity_basis","representation","request_profiles","experiences"],"properties":{"v":{"type":"integer","enum":[1,2,3],"description":"Manifest version (meg_v)","x-stability":"stable"},"scanned_at":{"type":["string","null"],"format":"date-time","description":"When the scan started","x-stability":"stable"},"recorded_at":{"type":"string","format":"date-time","description":"When this manifest was sealed","x-stability":"stable"},"observer":{"type":"object","additionalProperties":false,"required":["meg_v","vantage"],"properties":{"version_id":{"description":"Deployment id of the build that observed","type":["string","null"],"x-stability":"stable"},"version_tag":{"description":"Code digest of that deployment (first 16 hex of SHA-256)","type":["string","null"],"x-stability":"stable"},"score_version":{"type":["integer","null"],"x-stability":"stable"},"meg_v":{"type":"integer","x-stability":"stable"},"vantage":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"type":"string","x-stability":"provisional"},"colo":{"description":"Edge location the requests left from","type":["string","null"],"x-stability":"provisional"}},"x-stability":"provisional"}},"x-stability":"stable"},"identity_basis":{"description":"States that every identity was sent by CrawlCheck from its own network, never by the named operator","type":"string","x-stability":"stable"},"representation":{"description":"What sha256 and bytes are computed over","type":"string","x-stability":"stable"},"stored_means":{"description":"What the stored field promises (v2+)","type":"string","x-stability":"stable"},"request_profiles":{"type":"object","description":"Request headers and, for replayable probes, method, redirect mode and RPC request metadata, keyed by rp1: id (SHA-256 of their canonical JSON, first 16 hex)","propertyNames":{"pattern":"^rp1:[0-9a-f]{16}$"},"additionalProperties":{"type":"object","additionalProperties":{"type":"string"}},"x-stability":"provisional"},"experiences":{"type":"array","items":{"$ref":"#/$defs/ExperienceV1"},"x-stability":"stable"},"capability_decisions":{"type":"array","description":"Informational capability decisions with sealed input references and replay rule revisions","items":{"type":"object","additionalProperties":false,"required":["decision_id","revision","kind","capability_id","protocol","method","path","declaration","probe","requires_body"],"properties":{"decision_id":{"type":"string","pattern":"^capd1:[0-9a-f]{32}$","x-stability":"stable"},"revision":{"type":"string","x-stability":"stable"},"kind":{"enum":["declared_endpoint_missing","declared_media_mismatch"],"x-stability":"stable"},"capability_id":{"type":"string","x-stability":"stable"},"protocol":{"enum":["openapi","mcp"],"x-stability":"stable"},"method":{"type":["string","null"],"x-stability":"stable"},"path":{"type":["string","null"],"x-stability":"stable"},"declaration":{"type":"string","x-stability":"stable"},"probe":{"type":"string","x-stability":"stable"},"requires_body":{"type":"boolean","x-stability":"stable"}}},"x-stability":"stable"},"roots":{"type":"object","additionalProperties":false,"required":["v","recipe","experiences","decisions","lineage"],"description":"v3: sealed Merkle roots, so one fetch, one decision or one business fact can be proven inside this manifest without disclosing the others (/api/explain carries the inclusion path)","properties":{"v":{"type":"integer","x-stability":"stable"},"recipe":{"type":"string","x-stability":"internal"},"experiences":{"type":"object","additionalProperties":false,"required":["n","root"],"properties":{"n":{"type":"integer","minimum":0,"x-stability":"stable"},"root":{"type":"string","pattern":"^([0-9a-f]{64})?$","description":"Merkle root over the leaves; empty when n is 0","x-stability":"stable"}},"x-stability":"stable"},"decisions":{"type":"object","additionalProperties":false,"required":["n","root"],"properties":{"n":{"type":"integer","minimum":0,"x-stability":"stable"},"root":{"type":"string","pattern":"^([0-9a-f]{64})?$","description":"Merkle root over the leaves; empty when n is 0","x-stability":"stable"}},"x-stability":"stable"},"lineage":{"type":"object","additionalProperties":false,"required":["n","root"],"properties":{"n":{"type":"integer","minimum":0,"x-stability":"stable"},"root":{"type":"string","pattern":"^([0-9a-f]{64})?$","description":"Merkle root over the leaves; empty when n is 0","x-stability":"stable"}},"x-stability":"stable"}},"x-stability":"stable"}},"allOf":[{"if":{"properties":{"v":{"const":3}}},"then":{"required":["roots","stored_means"]}}],"x-stability":"stable"},"ExperienceV1":{"type":"object","additionalProperties":false,"required":["experience_id","role","identity","url","status","bytes","stored","observed_at"],"properties":{"experience_id":{"type":"string","pattern":"^ex1:[0-9a-f]{32}$","description":"SHA-256 over subject, identity, vantage, request profile, representation, time and observer version","x-stability":"stable"},"role":{"type":"string","enum":["page","machine_file","identity_probe","capability_declaration","capability_probe","capability_probe_ack","fresh_read"],"description":"fresh_read: a cache-busting re-read the stale-cache rule compared the served page against","x-stability":"stable"},"identity":{"description":"Which identity sent it: crawlcheck, or an AV identity id (gptbot, claudebot, browser, control ...)","type":"string","x-stability":"stable"},"url":{"type":"string","x-stability":"stable"},"final_url":{"type":["string","null"],"x-stability":"stable"},"status":{"type":["integer","null"],"x-stability":"stable"},"content_type":{"type":["string","null"],"x-stability":"stable"},"bytes":{"type":"integer","minimum":0,"x-stability":"stable"},"sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"x-stability":"stable"},"body_truncated":{"const":true,"description":"The body exceeded its read cap; its original bytes are unavailable for replay","x-stability":"stable"},"stored_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","x-stability":"stable"},"masked":{"type":"object","properties":{"kinds":{"type":"object","x-stability":"provisional"},"method":{"type":"string","x-stability":"stable"}},"x-stability":"stable"},"stored":{"type":"string","enum":["kept","already_held","write_failed","not_kept_no_binding","write_unconfirmed","not_kept_over_size_cap","not_kept_over_record_budget","no_body"],"description":"kept / already_held: the bytes are in the store under sha256 (check with /api/artifact/<sha256>?verify=1); write_unconfirmed: still in flight when the manifest was sealed","x-stability":"stable"},"request_profile":{"anyOf":[{"type":"string","pattern":"^rp1:[0-9a-f]{16}$"},{"type":"null"}],"x-stability":"stable"},"observed_at":{"type":["string","null"],"x-stability":"stable"},"error":{"type":["string","null"],"x-stability":"provisional"},"via":{"description":"Present when the fetch did not go direct: 'self-scan vantage' = a self-scan of crawlcheck.io fetched through a separate vantage","type":["string","null"],"x-stability":"provisional"}},"x-stability":"stable"},"ManifestSignatureV1":{"type":"object","required":["v","alg","kid","over","message","sig"],"description":"Carried beside the manifest in the scan record (meg.signature), never inside it","properties":{"v":{"type":"integer","x-stability":"stable"},"alg":{"const":"Ed25519","x-stability":"stable"},"kid":{"type":"string","x-stability":"stable"},"key_storage":{"type":["string","null"],"x-stability":"internal"},"over":{"const":"manifest_sha256","x-stability":"stable"},"message":{"type":"string","pattern":"^crawlcheck-meg-manifest-v1\\n[0-9a-f]{64}$","x-stability":"stable"},"sig":{"description":"base64url Ed25519 signature over message","type":"string","x-stability":"stable"},"signed_at":{"type":"string","x-stability":"stable"},"key_directory":{"type":"string","x-stability":"stable"},"verify":{"type":"string","x-stability":"stable"}},"x-stability":"stable"}},"x-compatibility":{"policy":"https://crawlcheck.io/docs/api/compatibility","levels":{"stable":{"window_days":180,"may_change":"Nothing within v1. Removing, renaming or retyping it needs a new major version (/api/v2), announced at least 180 days ahead.","notice":"Deprecation and Sunset headers on every response that carries it, deprecated:true in the schema, an entry in x-compatibility.deprecations, release notes."},"provisional":{"window_days":30,"may_change":"Its shape may change within v1 (renamed, restructured, removed) after at least 30 days' notice. Never silently.","notice":"The same four signals as stable, 30 days ahead."},"internal":{"window_days":0,"may_change":"Anything, at any time. It is in the response so you can see what the record is built from, not to be built on.","notice":"None promised."}},"fields":{"stable":249,"provisional":288,"internal":10},"total":547,"rule":"Every field carries x-stability. A field is never more stable than the field that contains it. Clients must ignore fields they do not know: adding a field is never a breaking change at any level.","deprecations":[]}}