Skip to navigation

/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

NameDescription
disease_codeGIDEON 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