/diseases/events

GET

/diseases/events

GET

/diseases/events

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

200Diseases_/diseases/events_example

{
  "data": [
    {
      "id": "o_12836",
      "city": "Sinoe",
      "type": "outbreak",
      "cases": 31,
      "state": "Sino",
      "deaths": 13,
      "region": "Sinoe",
      "country": "Liberia",
      "disease": "Meningitis - bacterial",
      "hash_id": "803728a8-96b1-444a-b719-550657f72930",
      "is_human": true,
      "latitude": "5.33333",
      "is_animal": false,
      "longitude": "-8.76667",
      "is_outbreak": true,
      "is_sporadic": false,
      "update_date": "2026-03-06 22:36:51",
      "country_code": "G202",
      "disease_code": 11480,
      "outbreak_end": 2025,
      "is_travelcase": false,
      "outbreak_start": 2017,
      "update_date_epoch": 1772836611,
      "outbreak_last_reported": 2025,
      "outbreak_first_reported": 2017
    },
    {
      "id": "o_24311",
      "city": "string",
      "type": "outbreak",
      "cases": 34571873,
      "state": "string",
      "deaths": 35934,
      "region": "Nationwide",
      "country": "South Korea",
      "disease": "COVID-19",
      "hash_id": "3f9523b0-0ad7-4ba8-8cbf-d114cd12f2c3",
      "is_human": true,
      "latitude": "35.907757",
      "is_animal": true,
      "longitude": "127.766922",
      "is_outbreak": true,
      "is_sporadic": false,
      "update_date": "2026-03-06 22:38:05",
      "country_code": "G197",
      "disease_code": 12683,
      "outbreak_end": 2025,
      "is_travelcase": false,
      "outbreak_start": 2020,
      "update_date_epoch": 1772836685,
      "outbreak_last_reported": 2025,
      "outbreak_first_reported": 2020
    }
  ]
}

Returns outbreak-style event rows across all diseases for a calendar year: outbreaks, sporadic reports, travel-linked rows, and related type combinations—not limited to classical “outbreak” records only.

Required query parameters

Name	Description
`year`	Calendar year to match. A row is included when `year` falls within its derived reporting span or when `publication_year` equals `year`. Omitting `year` returns 404 with `{ "error": { "message": "year is required." } }`. Non-numeric values return 404 (`Invalid year.`).

Optional query parameters

Name	Description
`return`	`simple` (default), `detailed`, `minimal`, or `compact`. `detailed` adds notes, vehicle, setting, population, pathogen, clinical, and resolved `references`, and uses `limit` / `offset` pagination with `total` in the envelope. `minimal` and `compact` return reduced field sets (no derived *`is_` type flags on `minimal`**).
`limit` / `offset`	Pagination for `return=detailed` only.

Aggregate placeholder country G100 is excluded from results.

Each simple / detailed row includes update timestamps, hash_id, id (o_ prefix), year fields (outbreak_first_reported / outbreak_last_reported alongside legacy outbreak_start / outbreak_end), publication_year, counts (cases, deaths, animal_cases, animal_deaths), geography (region, country_code, country, state, city, latitude, longitude), disease_code, disease, boolean flags is_animal / is_human, and derived booleans is_travelcase, is_outbreak, is_sporadic parsed from type.

outbreak_start (deprecated) – Same value as outbreak_first_reported.
outbreak_end (deprecated) – Prefer outbreak_last_reported.

The response is { "data": [ … ] } (and pagination fields when return=detailed) with no top-level timestamp.

For the same event feed scoped to one disease, use GET /diseases/{disease_code}/events; for one country’s feed, GET /countries/{country_code}/events.

Authentication

Authorizationstring

API Key authentication via header

Query parameters

yearintegerOptional

Required. Calendar year filter.

returnstringOptional

simple | detailed | minimal | compact

Response

datalist of objects