{"openapi":"3.1.0","info":{"title":"HealthIT API","version":"1.0.0","description":"Versioned healthcare-technology records with explicit evidence status, unknowns, and exclusion reasons."},"paths":{"/api/v1/vendors":{"get":{"summary":"List vendors","responses":{"200":{"description":"Snapshot-bound vendor list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorList"}}}}}}},"/api/v1/vendors/{slug}":{"get":{"summary":"Get one vendor","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Vendor record"},"404":{"description":"Unknown slug"}}}},"/api/v1/categories":{"get":{"summary":"List workflows","responses":{"200":{"description":"Categories"}}}},"/api/v1/signals":{"get":{"summary":"List forecast signals","responses":{"200":{"description":"Signals"}}}},"/status.json":{"get":{"summary":"Release identity","responses":{"200":{"description":"App and snapshot identity"}}}},"/llms.txt":{"get":{"summary":"Machine discovery index","responses":{"200":{"description":"Plain text"}}}},"/.well-known/agents.json":{"get":{"summary":"Agent capability manifest","responses":{"200":{"description":"Machine-readable provenance and refusal contract"}}}},"/api/v1/feedback":{"get":{"summary":"Discover the private feedback contract","responses":{"200":{"description":"Field and safety requirements"}}},"post":{"summary":"Send private, non-PHI feedback for editorial review","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback"}}}},"responses":{"202":{"description":"Private mail provider accepted the editorial handoff"},"422":{"description":"Validation failed"},"503":{"description":"Private delivery unavailable; nothing was stored"}}}},"/api/vendors":{"get":{"summary":"Deprecated compatibility list","deprecated":true,"responses":{"200":{"description":"Legacy list"}}}},"/api/categories":{"get":{"summary":"Deprecated compatibility categories","deprecated":true,"responses":{"200":{"description":"Legacy categories"}}}},"/api/signals":{"get":{"summary":"Deprecated compatibility signals","deprecated":true,"responses":{"200":{"description":"Legacy signals"}}}}},"components":{"schemas":{"VendorList":{"type":"object","required":["snapshot_id","vendors"],"properties":{"snapshot_id":{"type":"string"},"snapshot_sha256":{"type":"string"},"evidence_cutoff_at":{"type":"string"},"method_versions":{"type":"object"},"vendors":{"type":"array","items":{"$ref":"#/components/schemas/Vendor"}}}},"Vendor":{"type":"object","properties":{"slug":{"type":"string"},"documentary_gate_status":{"type":"string","enum":["passed","failed","insufficient"]},"scenario_eligibility":{"type":"string","enum":["eligible","ineligible","unmapped"]},"comparability_status":{"type":"string","enum":["comparable","not_comparable"]},"decision_readiness":{"type":"string","enum":["ready","provisional","research_only"]},"critical_unknowns":{"type":"array","items":{"type":"string"}},"exclusion_reasons":{"type":"array","items":{"type":"object"}},"snapshot_id":{"type":"string"},"decision_admissible":{"type":"boolean","deprecated":true}}},"Feedback":{"type":"object","required":["kind","message","non_phi_confirmed"],"properties":{"communication_type":{"type":"string","enum":["support","feedback","complaint"],"default":"feedback"},"kind":{"type":"string","enum":["support_request","correction","evidence_gap","missing_product","usability","comment","complaint","question","other"]},"message":{"type":"string","minLength":12,"maxLength":4000},"context":{"type":"string","maxLength":200},"source_url":{"type":"string","format":"uri","description":"Required for correction and evidence_gap."},"email":{"type":"string","format":"email","description":"Optional; only used to reply and never published."},"organization":{"type":"string","maxLength":160},"non_phi_confirmed":{"type":"boolean","const":true,"description":"Must be true. Do not send PHI."}}}}}}