Skip to navigation

/diseases/outbreaks/distribution/{country_code}/summary

View as Markdown

Returns a per-disease summary for one reporting country: each item is disease_code, disease, and cases.

cases is not a simple sum of every row. The server groups rows by disease and derives a single number as the maximum of several geographic rules (nationwide marker, unknown subdivision, state-level totals, and an “all city-level” sum when every row for that disease is city-specific).

year is optional. With year, behavior aligns with GET /diseases/outbreaks/distribution/{country_code}?year=… (year overlap + outbreak/sporadic types only). When year is omitted, the set of rows is broader (see query parameter note).

For individual outbreak rows, use GET /diseases/outbreaks/distribution/{country_code} or GET /diseases/outbreaks/filter. For recent activity only, GET /diseases/outbreaks/distribution/{country_code}/alerts uses days, not year.

Path parameters

NameDescription
country_codeGIDEON country code for the reporting country.

Query parameters

NameRequiredDescription
yearNoCalendar year filter; see above for interaction with row selection and type filtering.

Authentication

Authorizationstring
API Key authentication via header

Query parameters

yearintegerOptional

Optional calendar year. When set, uses the same year window as GET /diseases/outbreaks/distribution/{country_code} and only types containing outbreak or sporadic. When omitted, aggregates all rows for the country with a non-null disease id (no year filter and no outbreak/sporadic type filter).

Response

OK
datalist of objects