/diseases/{disease_code}/distribution/map/legends

View as Markdown
Returns **legend rows** for coloring **global distribution maps** of this disease: each row is one display band with a human-readable **`legend`** label and numeric bounds **`min_value`** / **`max_value`**, plus **`exclusive_min`** and **`exclusive_max`** (whether each endpoint is treated as inside the band). Use this together with **`GET /diseases/{disease_code}/distribution/map/labels`** (numeric cut points paired with short names) and **`GET /diseases/{disease_code}/distribution/map/values`** (per-country metric values). There are **no** query parameters. #### **Path parameters** | Name | Description | | --- | --- | | `disease_code` | GIDEON disease id (numeric string in the path). | #### **Success response** `{ "data": [ … ] }` — each element has **`legend`**, **`min_value`**, **`max_value`**, **`exclusive_min`**, **`exclusive_max`**. The **count of rows** and the **numeric cutoffs** depend on the disease: many diseases return a **standard three-band** scale (not endemic / sporadic / endemic). When expanded map settings exist for the disease, the API returns **additional graduated bands** (same field shape, more rows). One disease id uses a **fixed alternate** multi-band legend for a specialized resistance map; clients should render whatever array is returned. The endpoint always returns **200** with a non-empty **`data`** array for valid numeric ids; unknown ids are not validated separately and may still receive a generic legend set.

Authentication

Authorizationstring
API Key authentication via header

Response

OK
datalist of objects