Skip to navigation
GIDEON API 1.0Diseases

/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

NameDescription
country_codeGIDEON country code for the reporting country.

Query parameters

NameRequiredDescription
daysNoInteger look-back days (default 5; capped by max_alert_days).
returnNosimple (default) or detailed.
limit / offsetNoFor 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