/diseases/{disease_code}/events

GET

/diseases/%7Bdisease_code%7D/events

GET

/diseases/%7Bdisease_code%7D/events

curl -G https://api.gideononline.com/diseases/%7Bdisease_code%7D/events \
     -H "Authorization: <apiKey>" \
     -d return=simple \
     -d year=2020

200Disease - Details_/diseases/{disease_code}/events_example

{
  "data": [
    {
      "id": "o_24211",
      "type": "outbreak",
      "cases": 27,
      "state": "Yogyakarta",
      "deaths": 1,
      "region": "Yogyakarta",
      "country": "Indonesia",
      "disease": "Anthrax",
      "hash_id": "cb55b83f-6cb4-49cd-a389-41da624bce11",
      "is_human": true,
      "latitude": "-7.8008",
      "longitude": "110.34393",
      "is_outbreak": true,
      "is_sporadic": false,
      "update_date": "2026-03-06 22:38:05",
      "country_code": "G185",
      "disease_code": 10100,
      "is_travelcase": false,
      "outbreak_start": 2020,
      "update_date_epoch": 1772836685,
      "outbreak_last_reported": 2020,
      "outbreak_first_reported": 2020
    },
    {
      "id": "o_26776",
      "type": "outbreak",
      "cases": 3,
      "state": "Calabria",
      "deaths": 0,
      "region": "Calabria",
      "country": "Italy",
      "disease": "Anthrax",
      "hash_id": "54b532a1-6158-4743-8b22-f4d31633749c",
      "is_human": true,
      "latitude": "39",
      "longitude": "16.5",
      "is_outbreak": true,
      "is_sporadic": false,
      "update_date": "2026-03-06 22:38:18",
      "country_code": "G190",
      "disease_code": 10100,
      "is_travelcase": false,
      "outbreak_start": 2020,
      "update_date_epoch": 1772836698,
      "outbreak_last_reported": 2020,
      "outbreak_first_reported": 2020
    }
  ]
}

Returns infectious disease events for a single disease (outbreaks and related movement-linked records).

Path parameters

Name	Description
`disease_code`	GIDEON disease id (numeric), same value as in `GET /diseases`.

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.
`days`	No	If set, limits to events updated within the last N days; the API enforces a maximum N.
`limit`, `offset`	No	Used when `return=detailed` for pagination.

Response

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

Unknown or non-numeric disease ids return 404 with { "error": { "message": "Invalid disease id." } }.

Note: outbreak_start / outbreak_end are deprecated in favor of outbreak_first_reported / outbreak_last_reported.

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