/diseases/outbreaks/distribution/{country_code}/alerts

View as Markdown
Returns **recently updated** outbreak rows for a **single reporting country**, using the same handler and **`return=simple` / `detailed`** shapes as **`GET /diseases/outbreaks/distribution/{country_code}`** (simple = full `data` array; detailed = extra fields + pagination with **`limit`** / **`offset`**). **Time window:** rows must have **`last_update_date`** on or after midnight **N** calendar days ago (**`days`**), **and** either **`outbreak_start`** or **`outbreak_end`** equal to the **current calendar year** (server clock). This path does **not** apply the outbreak/sporadic-only type filter used when **`year`** is applied on the non-alerts distribution route. Do not pass **`year`** on this path, or the server will use that year-based branch instead of this rolling window. **`days`:** optional; default **5**. Must be ≤ server **`max_alert_days`** or the API returns **404** with `days can't be greater than …`. Compare **`GET /diseases/outbreaks/alerts`** (worldwide, different query naming in older Postman examples). For a fixed calendar year across types, use **`GET /diseases/outbreaks/distribution/{country_code}?year=…`**. - **`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 | | --- | --- | --- | | `days` | No | Integer look-back days (default **5**; capped by **`max_alert_days`**). | | `return` | No | `simple` (default) or `detailed`. | | `limit` / `offset` | No | For **`detailed`** only. |

Authentication

Authorizationstring
API Key authentication via header

Query parameters

daysintegerOptional

Look-back window in days from today (start of day). Default 5 if omitted. Cannot exceed server max_alert_days (returns 404 if too large).

Response

OK
datalist of objects