Skip to navigation
GIDEON API 1.0General

/countries/{country_code}/events

View as Markdown

Returns infectious disease events (outbreaks and related records) recorded for the given country.

Path parameters

NameDescription
country_codeGIDEON country code (see GET /countries).

Query parameters

NameRequiredDescription
returnNosimple (default), detailed, minimal, or compact—controls how much information each record includes.
yearNoIf set, limits results to that calendar year. Non-numeric values are rejected with an error response.
limit, offsetNoUsed when return=detailed for pagination.

Response

Usually a JSON object with a data array. With return=detailed, the response also includes pagination fields such as total and offset.

Authentication

Authorizationstring
API Key authentication via header

Query parameters

returnstringOptional

Response shape: simple (default), detailed, minimal, or compact. With detailed, results are paginated (use limit and offset).

yearintegerOptional

Optional calendar year filter. Must be numeric if provided; otherwise the API returns an error.

Response

OK
datalist of objects