/diseases/events

Returns **outbreak-style event rows across all diseases** for a calendar **`year`**: outbreaks, sporadic reports, travel-linked rows, and related **`type`** combinations—**not** limited to classical “outbreak” records only. #### **Required query parameters** | Name | Description | | --- | --- | | `year` | Calendar year to match. A row is included when **`year`** falls within its derived reporting span **or** when **`publication_year`** equals **`year`**. Omitting **`year`** returns **404** with `{ "error": { "message": "year is required." } }`. Non-numeric values return **404** (`Invalid year.`). | #### **Optional query parameters** | Name | Description | | --- | --- | | `return` | `simple` (default), `detailed`, `minimal`, or `compact`. **`detailed`** adds notes, vehicle, setting, population, pathogen, clinical, and resolved **`references`**, and uses **`limit`** / **`offset`** pagination with **`total`** in the envelope. **`minimal`** and **`compact`** return reduced field sets (no derived **`is_*`** type flags on **`minimal`**). | | `limit` / `offset` | Pagination for **`return=detailed`** only. | Aggregate placeholder country **`G100`** is **excluded** from results. Each **`simple`** / **`detailed`** row includes update timestamps, **`hash_id`**, **`id`** (`o_` prefix), year fields (**`outbreak_first_reported`** / **`outbreak_last_reported`** alongside legacy **`outbreak_start`** / **`outbreak_end`**), **`publication_year`**, counts (**`cases`**, **`deaths`**, **`animal_cases`**, **`animal_deaths`**), geography (**`region`**, **`country_code`**, **`country`**, **`state`**, **`city`**, **`latitude`**, **`longitude`**), **`disease_code`**, **`disease`**, boolean flags **`is_animal`** / **`is_human`**, and derived booleans **`is_travelcase`**, **`is_outbreak`**, **`is_sporadic`** parsed from **`type`**. - **`outbreak_start`** _(deprecated)_ – Same value as **`outbreak_first_reported`**. - **`outbreak_end`** _(deprecated)_ – Prefer **`outbreak_last_reported`**. The response is **`{ "data": [ … ] }`** (and pagination fields when **`return=detailed`**) with **no** top-level **`timestamp`**. For the same event feed **scoped to one disease**, use **`GET /diseases/{disease_code}/events`**; for **one country’s** feed, **`GET /countries/{country_code}/events`**.