/diseases/outbreaks/filter

GET

GET

/diseases/outbreaks/filter

curl -G https://api.gideononline.com/diseases/outbreaks/filter \
     -H "Authorization: <apiKey>" \
     -d disease=10040 \
     -d country=G292

200Diseases_/diseases/outbreaks/filter_example

{
  "data": [
    {
      "id": "o_38752",
      "city": "Boston",
      "type": "outbreak",
      "cases": 200,
      "state": "Massachusetts",
      "region": "Massachusetts - Boston",
      "country": "United States",
      "disease": "HIV/AIDS",
      "hash_id": "aed6b4e4-8322-4416-861d-d898238ace6e",
      "latitude": "42.3555",
      "longitude": "-71.06575",
      "vehicle_id": 1361,
      "update_date": "2026-03-06 22:39:25",
      "country_code": "G292",
      "disease_code": 10040,
      "setting_name": "",
      "vehicle_name": "drug abuse",
      "outbreak_start": 2025,
      "update_date_epoch": 1772836765,
      "origin_country_code": "",
      "outbreak_last_reported": 2025,
      "outbreak_first_reported": 2025
    }
  ]
}

Returns outbreak rows in simple mode by default (return=simple). Each row includes update_date, update_date_epoch (Unix seconds; derived from each row’s update time), geography, counts, and resolved names (vehicle, pathogen, populations, etc.). id is prefixed (o_, t_, sp_) from event type and a stable numeric key.

Year overlap uses the query parameters outbreak_start and outbreak_end (calendar years) with derived span logic on the server.

If the filtered row count exceeds outbreaks_max_records_without_filters (default 500), the API returns HTTP 200 with { "data": { "record_count", "max_records" } } instead of listing rows.

Use GET /diseases/outbreaks/filter-options for facet values. Use GET /diseases/outbreaks/regions (requires countryId) for subdivision pickers; use GET /diseases/outbreaks/settings, GET /diseases/outbreaks/population, GET /diseases/outbreaks/pathogens, and GET /diseases/outbreaks/vehicles for the full setting, population, pathogen, and vehicle catalogs (optional prefix search where noted on each request).

Query parameters (optional; combine as needed)

Name	Description
`disease`	Numeric GIDEON disease identifier.
`country`	GIDEON country code for the reporting country.
`originCountry`	Country code for the country of origin (imported exposure), when applicable.
`type`	Substring match on stored event `type` (e.g. outbreak, sporadic, travelcase).
`outbreak_start` / `outbreak_end`	Calendar-year overlap window.
`region`	Subdivision id (`region_code` from `GET /diseases/outbreaks/regions` with the same country as `countryId`, or filter-options `region_id`).
`setting`	Setting id (`setting_code` from `GET /diseases/outbreaks/settings` or filter-options).
`population`	Human population id (`population_code` from `GET /diseases/outbreaks/population` with `is_human=1`, or filter-options `data.populations`).
`animalPopulation`	Animal population id (`population_code` from `GET /diseases/outbreaks/population` with `is_human=0`, or filter-options `data.animal_populations` as `animal_population_code`).
`vehicle`	Vehicle id (`vehicle_code` from `GET /diseases/outbreaks/vehicles` or filter-options).
`pathogen`	Pathogen id (`pathogen_code` from `GET /diseases/outbreaks/pathogens` or filter-options).
`humanCases` / `humanDeaths` / `animalCases` / `animalDeaths`	Numeric filters (same operator rules as similar endpoints).
`return`	`simple` (default) or `detailed` (paginated, extra fields).

Success with rows (simple)

{ "data": [ ... ] } — the Postman example shows one row for brevity (from api-dev; values change).

Authentication

Authorizationstring

API Key authentication via header

Query parameters

diseaseintegerOptional

Numeric GIDEON disease identifier.

countrystringOptional

GIDEON country code for the reporting country.

Response

datalist of objects