For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://api-doc-new.gideononline.com/gideon-api-1-0/diseases/llms.txt. For full documentation content, see https://api-doc-new.gideononline.com/gideon-api-1-0/diseases/llms-full.txt. # /diseases/outbreaks/filter-options GET https://api.gideononline.com/diseases/outbreaks/filter-options Returns **distinct filter values** for outbreak UIs, aligned with **`GET /diseases/outbreaks/filter`**. Pass the same optional query parameters to reflect the current filter context. With **no** parameters, a faster path loads options from the full outbreak set. With **any** filter present, each facet’s options are computed with that facet relaxed. - **`regions`** — Only when **`country`** is set and subdivision-level geography exists; items use `region_id` and `region_name`. - **`source_countries`** overlaps reporting-country options; **`countries`** merges reporting and origin country codes (prefer **`countries`** for new integrations where noted in release notes). - **`years`** — `outbreak_start_years` merges start years with publication years; `outbreak_end_years` uses end year or start when end is missing. - **`eventType`** — Maps each row’s **`type`** field to `event_code` / `event_name` (Outbreak, Cross-border, Sporadic). - **`GET /diseases/outbreaks/regions`** — pass **`countryId`** (reporting country); returns **`region_code`** / **`region`** (same id as **`region_id`** / name as **`region_name`** in **`data.regions`** here). Optional **`search`** prefixes the subdivision name. - **`GET /diseases/outbreaks/settings`**, **`GET /diseases/outbreaks/population`**, **`GET /diseases/outbreaks/pathogens`**, and **`GET /diseases/outbreaks/vehicles`** return the full setting, population, pathogen, and vehicle catalogs with optional prefix **`search`** on labels (same codes as `data.settings`, `data.populations` / `data.animal_populations`, `data.pathogens`, and `data.vehicles` here). #### **Response** `data` contains `settings`, `populations`, `vehicles`, `pathogens`, `regions`, `animal_populations`, `countries`, `source_countries`, `origin_countries`, `diseases`, `eventType`, `years`. The saved example trims each list to **one** item (and a few sample years); live responses are much larger. Reference: https://api-doc-new.gideononline.com/gideon-api-1-0/diseases/diseases-outbreaks-filter-options ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /diseases/outbreaks/filter-options: get: operationId: diseases-outbreaks-filter-options summary: /diseases/outbreaks/filter-options description: >- Returns **distinct filter values** for outbreak UIs, aligned with **`GET /diseases/outbreaks/filter`**. Pass the same optional query parameters to reflect the current filter context. With **no** parameters, a faster path loads options from the full outbreak set. With **any** filter present, each facet’s options are computed with that facet relaxed. - **`regions`** — Only when **`country`** is set and subdivision-level geography exists; items use `region_id` and `region_name`. - **`source_countries`** overlaps reporting-country options; **`countries`** merges reporting and origin country codes (prefer **`countries`** for new integrations where noted in release notes). - **`years`** — `outbreak_start_years` merges start years with publication years; `outbreak_end_years` uses end year or start when end is missing. - **`eventType`** — Maps each row’s **`type`** field to `event_code` / `event_name` (Outbreak, Cross-border, Sporadic). - **`GET /diseases/outbreaks/regions`** — pass **`countryId`** (reporting country); returns **`region_code`** / **`region`** (same id as **`region_id`** / name as **`region_name`** in **`data.regions`** here). Optional **`search`** prefixes the subdivision name. - **`GET /diseases/outbreaks/settings`**, **`GET /diseases/outbreaks/population`**, **`GET /diseases/outbreaks/pathogens`**, and **`GET /diseases/outbreaks/vehicles`** return the full setting, population, pathogen, and vehicle catalogs with optional prefix **`search`** on labels (same codes as `data.settings`, `data.populations` / `data.animal_populations`, `data.pathogens`, and `data.vehicles` here). #### **Response** `data` contains `settings`, `populations`, `vehicles`, `pathogens`, `regions`, `animal_populations`, `countries`, `source_countries`, `origin_countries`, `diseases`, `eventType`, `years`. The saved example trims each list to **one** item (and a few sample years); live responses are much larger. tags: - subpackage_diseases parameters: - name: Authorization in: header required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/Diseases_/diseases/outbreaks/filter-options_Response_200 servers: - url: https://api.gideononline.com - url: https://api-test.gideononline.com components: schemas: DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataYears: type: object properties: outbreak_end_years: type: array items: type: integer outbreak_start_years: type: array items: type: integer required: - outbreak_end_years - outbreak_start_years title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataYears DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataDiseasesItems: type: object properties: disease_code: type: integer disease_name: type: string required: - disease_code - disease_name title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataDiseasesItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataSettingsItems: type: object properties: setting: type: string setting_code: type: integer required: - setting - setting_code title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataSettingsItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataVehiclesItems: type: object properties: vehicle: type: string vehicle_code: type: integer required: - vehicle - vehicle_code title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataVehiclesItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataCountriesItems: type: object properties: country_id: type: string country_name: type: string required: - country_id - country_name title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataCountriesItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataEventTypeItems: type: object properties: event_code: type: string event_name: type: string required: - event_code - event_name title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataEventTypeItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataPathogensItems: type: object properties: pathogen: type: string pathogen_code: type: integer required: - pathogen - pathogen_code title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataPathogensItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataPopulationsItems: type: object properties: is_human: type: integer population: type: string population_code: type: integer required: - is_human - population - population_code title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataPopulationsItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataOriginCountriesItems: type: object properties: origin_country_id: type: string origin_country_name: type: string required: - origin_country_id - origin_country_name title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataOriginCountriesItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataSourceCountriesItems: type: object properties: source_country_id: type: string source_country_name: type: string required: - source_country_id - source_country_name title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataSourceCountriesItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataAnimalPopulationsItems: type: object properties: is_human: type: integer animal_population: type: string animal_population_code: type: integer required: - is_human - animal_population - animal_population_code title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataAnimalPopulationsItems DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaData: type: object properties: years: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataYears regions: type: array items: description: Any type diseases: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataDiseasesItems settings: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataSettingsItems vehicles: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataVehiclesItems countries: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataCountriesItems eventType: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataEventTypeItems pathogens: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataPathogensItems populations: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataPopulationsItems origin_countries: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataOriginCountriesItems source_countries: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataSourceCountriesItems animal_populations: type: array items: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaDataAnimalPopulationsItems required: - years - regions - diseases - settings - vehicles - countries - eventType - pathogens - populations - origin_countries - source_countries - animal_populations title: >- DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaData Diseases_/diseases/outbreaks/filter-options_Response_200: type: object properties: data: $ref: >- #/components/schemas/DiseasesOutbreaksFilterOptionsGetResponsesContentApplicationJsonSchemaData required: - data title: Diseases_/diseases/outbreaks/filter-options_Response_200 securitySchemes: apiKeyAuth: type: apiKey in: header name: Authorization ``` ## SDK Code Examples ```python Diseases_/diseases/outbreaks/filter-options_example import requests url = "https://api.gideononline.com/diseases/outbreaks/filter-options" headers = {"Authorization": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Diseases_/diseases/outbreaks/filter-options_example const url = 'https://api.gideononline.com/diseases/outbreaks/filter-options'; const options = {method: 'GET', headers: {Authorization: ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Diseases_/diseases/outbreaks/filter-options_example package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.gideononline.com/diseases/outbreaks/filter-options" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Diseases_/diseases/outbreaks/filter-options_example require 'uri' require 'net/http' url = URI("https://api.gideononline.com/diseases/outbreaks/filter-options") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = '' response = http.request(request) puts response.read_body ``` ```java Diseases_/diseases/outbreaks/filter-options_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.gideononline.com/diseases/outbreaks/filter-options") .header("Authorization", "") .asString(); ``` ```php Diseases_/diseases/outbreaks/filter-options_example request('GET', 'https://api.gideononline.com/diseases/outbreaks/filter-options', [ 'headers' => [ 'Authorization' => '', ], ]); echo $response->getBody(); ``` ```csharp Diseases_/diseases/outbreaks/filter-options_example using RestSharp; var client = new RestClient("https://api.gideononline.com/diseases/outbreaks/filter-options"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", ""); IRestResponse response = client.Execute(request); ``` ```swift Diseases_/diseases/outbreaks/filter-options_example import Foundation let headers = ["Authorization": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.gideononline.com/diseases/outbreaks/filter-options")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```