/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** | Name | Description | | --- | --- | | `country_code` | GIDEON country code for the reporting country. | #### **Query parameters** | Name | Required | Description | | --- | --- | --- | | `year` | No | Calendar 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