Skip to navigation

/diseases/{disease_code}/ongoing-outbreaks

View as Markdown

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_date on the response) must fall within roughly the last two months (from the API server’s current date/time).
  • Catalog rows (source = OUTBREAKS): type includes 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 as outbreak_first_reported / outbreak_last_reported alongside legacy outbreak_start / outbreak_end).
  • News rows (source = gdn_outbreak_news): approved outbreak-news items created inside the same rolling window, with type on the row set to outbreak; duplicates that match an already-returned catalog row (same disease, country, and place identifier) are omitted.

Path parameters

NameDescription
disease_codeGIDEON disease id (numeric string in the path).

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_reported and legacy outbreak_start / outbreak_end), publication_year, counts (cases, deaths), geography (region, city, state, latitude, longitude, country_code, resolved country_name), is_animal / is_human (booleans or null), admin labels (admin_1_name, admin_2_name, admin_3_name), source (OUTBREAKS vs gdn_outbreak_news), and href (relative—either an explore path for catalog rows or /events/{hash_id} for news rows). News-only rows may also include outbreak_date (ISO date) when present.
  • timestamp: Unix epoch (seconds) of the latest catalog update stamp used for this disease’s outbreak feed, or null when 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
datalist of objects
timestampinteger