/diseases/{disease_code}/outbreaks/countries

GET

/diseases/%7Bdisease_code%7D/outbreaks/countries

Returns a per-country aggregate of outbreak and sporadic records for one disease: total cases, deaths, and outbreaks (row count), plus the country’s display name, GIDEON country_code, and gid_0 (ISO 3166-1 alpha-3 when available).

You must supply at least one of year or days. If both are present, days wins (the rolling window logic is applied first).

Path parameters

Name	Description
`disease_code`	GIDEON disease id (numeric string in the path).

Query parameters

Name	Required	Description
`year`	One of `year` or `days`	Calendar year; a country is included when any matching record’s reporting span touches this year (via the start/end year fields on those records). Must be numeric.
`days`	One of `year` or `days`	Rolling look-back: only records whose last-update timestamp falls within the last N days, and whose reporting span touches the current calendar year. Must be numeric.

Filtering notes (behavioral)

Only rows whose type includes outbreak or sporadic are counted.
Synthetic worldwide and simulator-style country codes are omitted from the totals.
Whole-country “nationwide” summary rows are omitted so the breakdown stays location-specific.

Success response

{ "data": [ … ] } — each item has country_name, country_code, cases (integer sum, or an empty string when none), deaths (integer sum, or empty string when none), outbreaks (integer count of matching records), gid_0 (alpha-3 or null), and year (the year you passed, or the current calendar year when you used days). Results are sorted by cases descending.

Errors

HTTP status	When
400	Neither `year` nor `days` — `{ "error": { "message": "Either days or year parameter is required." } }`.
400	Non-numeric `days` — `Invalid days parameter.`
400	Non-numeric `year` — `Invalid year parameter.`

Unknown disease ids typically yield 200 with an empty data array.

Authentication

Authorizationstring

API Key authentication via header

Query parameters

yearintegerOptional

Calendar year filter (supply this or days).

Response

datalist of objects