/countries/{country_code}/events | gideononline

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

Path parameters

Name	Description
`country_code`	GIDEON country code (see `GET /countries`).

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.
`limit`, `offset`	No	Used 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.

Returns infectious disease **events** (outbreaks and related records) recorded for the given **country**. #### **Path parameters** | Name | Description | | --- | --- | | `country_code` | GIDEON country code (see `GET /countries`). | #### **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. | | `limit`, `offset` | No | Used 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

datalist of objects

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

Path parameters

Name	Description
`country_code`	GIDEON country code (see `GET /countries`).

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.
`limit`, `offset`	No	Used 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.

1	curl -G https://api.gideononline.com/countries/%7Bcountry_code%7D/events \
2	-H "Authorization: <apiKey>" \
3	-d return=simple \
4	-d year=2024

1	{
2	"data": [
3	{
4	"country": "United States",
5	"disease": "Influenza",
6	"country_code": "G292",
7	"disease_code": 11170
8	}
9	]
10	}