{"openapi":"3.1.0","info":{"title":"Harper OIG Exclusion Aggregator","version":"0.1.0","description":"Free public search over US federal and state healthcare exclusion lists. All results are potential name matches, not confirmed identities: the underlying government files contain no Social Security Numbers. Absence of a match is not a clearance – see /api/coverage for which jurisdictions are included."},"servers":[{"url":"https://oig.tryharper.app"}],"paths":{"/api/search":{"get":{"operationId":"searchExclusions","summary":"Search exclusion lists by name","description":"Returns potential name matches across covered jurisdictions. Verify any match against the official source and at https://exclusions.oig.hhs.gov before acting on it.","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"description":"Person or organization name."},{"name":"state","in":"query","schema":{"type":"string"},"description":"Two-letter jurisdiction code, or 'US' for federal."},{"name":"type","in":"query","schema":{"type":"string","enum":["individual","entity"]}},{"name":"include_inactive","in":"query","schema":{"type":"boolean"},"description":"Include reinstated or removed records."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Potential matches with their sources."},"429":{"description":"Rate limit exceeded."}}}},"/api/exclusion/{id}":{"get":{"operationId":"getExclusion","summary":"Retrieve one exclusion record","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The record."},"404":{"description":"Not found."}}}},"/api/coverage":{"get":{"operationId":"listCoverage","summary":"List every jurisdiction and its ingest status","description":"Includes jurisdictions that are not covered and why. Consult before concluding that someone is not excluded.","responses":{"200":{"description":"The coverage ledger."}}}},"/api/recent":{"get":{"operationId":"listRecentAdditions","summary":"List records recently added to the corpus","description":"Records ordered by when they first appeared in this dataset. firstSeenAt is an ingest date, not an exclusion date: a source ingested for the first time contributes decades of pre-existing exclusions all stamped with that day. Compare corpusFirstSeenAt against the requested window, and read each record's exclusionDate for when the government acted.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}},{"name":"state","in":"query","schema":{"type":"string"},"description":"Two-letter jurisdiction code, or 'US' for federal."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Additions, with per-day counts."}}}}}}