/diseases/outbreaks/distribution/{country_code}
/diseases/outbreaks/distribution/{country_code}
Returns outbreak and sporadic rows for a single reporting country ({country_code} — same GIDEON code as country on GET /diseases/outbreaks/filter).
Only events whose type field contains outbreak or sporadic are included (other event types are omitted).
year is required on this path. If it is missing, the API returns 404 with { "error": { "message": "year is required." } }.
return=simple(default): each row includes update timestamps, ids, year fields (outbreak_first_reported/outbreak_last_reportedalongside legacyoutbreak_start/outbreak_end), cases/deaths, resolvedregion, geography (city,statewhen present), and disease. The list is not paginated — large countries/years can return many rows.return=detailed: adds vehicle, setting, population, pathogen, clinical, notes, and resolved reference objects; results are paginated (data,total,offset,limit).
Related: GET /diseases/outbreaks/distribution/{country_code}/summary (aggregates); GET /diseases/outbreaks/distribution/{country_code}/alerts (recent updates; uses days, not year). For arbitrary filters across countries, use GET /diseases/outbreaks/filter.
outbreak_start/outbreak_endin responses are deprecated in favor ofoutbreak_first_reported/outbreak_last_reported.
Path parameters
Query parameters
Authentication
Query parameters
Calendar year filter (required for this path). A row matches if its first reported year, last reported span, or publication year intersects this year (server-side OR logic).