/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_reported`** alongside legacy **`outbreak_start`** / **`outbreak_end`**), cases/deaths, resolved **`region`**, geography (**`city`**, **`state`** when 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_end`** in responses are **deprecated** in favor of **`outbreak_first_reported`** / **`outbreak_last_reported`**.
#### **Path parameters**
| Name | Description |
| --- | --- |
| `country_code` | GIDEON country code for the reporting country. |
#### **Query parameters**
| Name | Required | Description |
| --- | --- | --- |
| `year` | **Yes** | Integer calendar year. |
| `return` | No | `simple` (default) or `detailed`. |
| `limit` / `offset` | No | For **`detailed`** only: page size and skip (subject to server and API-key caps). |
Authentication
Authorizationstring
API Key authentication via header
Query parameters
year
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).
Response
OK
data
