/diseases/{disease_code}/events
/diseases/{disease_code}/events
Returns infectious disease **events** for a **single disease** (outbreaks and related movement-linked records).
#### **Path parameters**
| Name | Description |
| --- | --- |
| `disease_code` | GIDEON disease id (numeric), same value as in `GET /diseases`. |
#### **Query parameters**
| Name | Required | Description |
| --- | --- | --- |
| `return` | No | `simple` (default), `detailed`, `minimal`, or `compact`—controls how much information each record includes. |
| `year` | No | If set, limits results to that calendar year. Non-numeric values are rejected with an error response. |
| `days` | No | If set, limits to events updated within the last **N** days; the API enforces a maximum **N**. |
| `limit`, `offset` | No | Used when `return=detailed` for pagination. |
#### **Response**
A JSON object with a `data` array. With `return=detailed`, the response also includes pagination fields such as `total` and `offset`.
Unknown or non-numeric disease ids return **404** with `{ "error": { "message": "Invalid disease id." } }`.
**Note:** **`outbreak_start`** / **`outbreak_end`** are deprecated in favor of **`outbreak_first_reported`** / **`outbreak_last_reported`**.
Authentication
Authorizationstring
API Key authentication via header
Query parameters
return
Response shape: simple (default), detailed, minimal, or compact. With detailed, results are paginated (use limit and offset).
year
Optional calendar year filter. Must be numeric if provided; otherwise the API returns an error.
Response
OK
data
