{"info":{"description":"Read-only access to 18,094 communications extracted from public U.S. Senate HSGAC document releases. Every response carries citations and usage caveats. Read /api/guidance before reporting anything from this corpus.","title":"COVID-19 Records API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/coverage":{"get":{"description":"Distinguishes 'covered but produced nothing' from 'outside this package's date range'. Check this before treating any absence as meaningful.","parameters":[{"description":"First month, YYYY-MM","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Last month, YYYY-MM","in":"query","name":"to","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Per-source monthly counts"}},"summary":"Where the record speaks and where it is silent"}},"/api/doc/{doc_id}":{"get":{"parameters":[{"in":"path","name":"doc_id","required":true,"schema":{"type":"string"}},{"description":"Neighbouring messages to include","in":"query","name":"context","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Document with citation"}},"summary":"One document in full, with participants and topics"}},"/api/glossary":{"get":{"responses":{"200":{"description":"Acronym list"}},"summary":"Acronyms used in the records"}},"/api/guidance":{"get":{"responses":{"200":{"description":"Caveats keyed by topic"}},"summary":"How to use this corpus without misreporting it"}},"/api/person/{person_id}":{"get":{"description":"Statement counts are returned by grade. Only `belief` may be reported as this person's own view.","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"string"}},{"description":"belief | context_required | excluded | all","in":"query","name":"grade","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Person profile"}},"summary":"Engagement, correspondents and graded statements"}},"/api/search":{"get":{"description":"mode=hybrid (default for questions) merges BM25 and dense retrieval. mode=keyword is literal and better for exact identifiers. Returns passages, never an answer.","parameters":[{"description":"Words, \"an exact phrase\", or a question","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"keyword | hybrid | semantic","in":"query","name":"mode","required":false,"schema":{"type":"string"}},{"description":"Person name or id; resolved via aliases","in":"query","name":"person","required":false,"schema":{"type":"string"}},{"description":"Topic id, e.g. lab_leak_origin","in":"query","name":"topic","required":false,"schema":{"type":"string"}},{"description":"Source package id","in":"query","name":"source","required":false,"schema":{"type":"string"}},{"description":"ISO date lower bound","in":"query","name":"since","required":false,"schema":{"type":"string"}},{"description":"ISO date upper bound","in":"query","name":"until","required":false,"schema":{"type":"string"}},{"description":"Maximum results (default 20, max 100)","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Ranked passages with citations"}},"summary":"Search the corpus; accepts natural questions"}},"/api/sources":{"get":{"responses":{"200":{"description":"Source list"}},"summary":"Released packages with SHA-256 and original URLs"}},"/api/timeline":{"get":{"parameters":[{"description":"Person name or id; resolved via aliases","in":"query","name":"person","required":false,"schema":{"type":"string"}},{"description":"Topic id, e.g. lab_leak_origin","in":"query","name":"topic","required":false,"schema":{"type":"string"}},{"description":"Source package id","in":"query","name":"source","required":false,"schema":{"type":"string"}},{"description":"ISO date lower bound","in":"query","name":"since","required":false,"schema":{"type":"string"}},{"description":"ISO date upper bound","in":"query","name":"until","required":false,"schema":{"type":"string"}},{"description":"Maximum results (default 20, max 100)","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Dated events with citations"}},"summary":"Chronological events for a person and/or topic"}},"/api/topic/{topic_id}":{"get":{"parameters":[{"in":"path","name":"topic_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Topic with timeline"}},"summary":"Principal voices and a statement timeline"}}},"servers":[{"url":"https://randpaulcovid.org"}]}