/diseases/{disease_code}/ongoing-outbreaks
/diseases/{disease_code}/ongoing-outbreaks
Returns a merged, recent “ongoing” view of outbreak-related activity for one disease: catalog outbreak/sporadic rows plus eligible curated news rows, deduplicated when they describe the same disease, country, and place id.
Scope (how rows are chosen)
- Rolling recency window: each row’s activity timestamp (
update_dateon the response) must fall within roughly the last two months (from the API server’s current date/time). - Catalog rows (
source=OUTBREAKS):typeincludes outbreak or sporadic; reporting country is not the synthetic worldwide or simulator codes; and the reporting span touches the current calendar year (via the start/end year fields exposed asoutbreak_first_reported/outbreak_last_reportedalongside legacyoutbreak_start/outbreak_end). - News rows (
source=gdn_outbreak_news): approved outbreak-news items created inside the same rolling window, withtypeon the row set to outbreak; duplicates that match an already-returned catalog row (same disease, country, and place identifier) are omitted.
Path parameters
Query parameters
None affect filtering or payload shape for this path.
Success response
{ "data": [ … ], "timestamp": … }
data: each object includes identifiers (id,hash_id),type, timestamps (update_date,update_date_epoch), year fields (outbreak_first_reported/outbreak_last_reportedand legacyoutbreak_start/outbreak_end),publication_year, counts (cases,deaths), geography (region,city,state,latitude,longitude,country_code, resolvedcountry_name),is_animal/is_human(booleans or null), admin labels (admin_1_name,admin_2_name,admin_3_name),source(OUTBREAKSvsgdn_outbreak_news), andhref(relative—either an explore path for catalog rows or/events/{hash_id}for news rows). News-only rows may also includeoutbreak_date(ISO date) when present.timestamp: Unix epoch (seconds) of the latest catalog update stamp used for this disease’s outbreak feed, ornullwhen none is available.
Unknown disease ids still return 200 with an empty data array when nothing matches.
Authentication
Authorizationstring
API Key authentication via header
Response
OK
data
timestamp