/diseases/{disease_code}/outbreaks/countries

Returns a **per-country aggregate** of outbreak and sporadic records for **one disease**: total **cases**, **deaths**, and **outbreaks** (row count), plus the country’s display name, GIDEON **`country_code`**, and **`gid_0`** (ISO 3166-1 alpha-3 when available). You must supply **at least one** of **`year`** or **`days`**. If both are present, **`days`** wins (the rolling window logic is applied first). #### **Path parameters** | Name | Description | | --- | --- | | `disease_code` | GIDEON disease id (numeric string in the path). | #### **Query parameters** | Name | Required | Description | | --- | --- | --- | | `year` | One of `year` or `days` | Calendar year; a country is included when any matching record’s reporting span touches this year (via the start/end year fields on those records). Must be numeric. | | `days` | One of `year` or `days` | Rolling look-back: only records whose last-update timestamp falls within the last **N** days, and whose reporting span touches the **current** calendar year. Must be numeric. | #### **Filtering notes (behavioral)** - Only rows whose **`type`** includes **outbreak** or **sporadic** are counted. - Synthetic worldwide and simulator-style country codes are omitted from the totals. - Whole-country “nationwide” summary rows are omitted so the breakdown stays location-specific. #### **Success response** `{ "data": [ … ] }` — each item has **`country_name`**, **`country_code`**, **`cases`** (integer sum, or an **empty string** when none), **`deaths`** (integer sum, or **empty string** when none), **`outbreaks`** (integer count of matching records), **`gid_0`** (alpha-3 or null), and **`year`** (the **`year`** you passed, or the **current calendar year** when you used **`days`**). Results are sorted by **`cases`** descending. #### **Errors** | HTTP status | When | | --- | --- | | **400** | Neither **`year`** nor **`days`** — `{ "error": { "message": "Either days or year parameter is required." } }`. | | **400** | Non-numeric **`days`** — `Invalid days parameter.` | | **400** | Non-numeric **`year`** — `Invalid year parameter.` | Unknown disease ids typically yield **200** with an empty **`data`** array.