PUBLIC REST API — LEGIONELLA ITALY

Documented REST endpoints for the Italian Legionella dataset. Released under CC BY 4.0. Designed for academic citation, data journalism and ECDC cross-referencing.

5 endpoints

Endpoint reference

All endpoints are GET, returning JSON unless the path suffix indicates otherwise. No authentication required for the public tier.

GET/api/v1/legionella/regionialias: /api/v1/legionella/regions

Returns the full regional dataset for the current data year (notified cases, incidence per 100k inhabitants, population).

curl -sS "https://123legionella.com/api/v1/legionella/regioni" -H "Accept: application/json"

The English alias /regions is recommended for international clients; the canonical Italian path /regioni remains supported for backwards compatibility.

GET/api/v1/legionella/regioni/{slug}alias: /api/v1/legionella/regions/{slug}

Returns the dataset row for a single region. Slugs follow the canonical Italian region list (e.g. lombardia, lazio, sicilia).

curl -sS "https://123legionella.com/api/v1/legionella/regioni/lombardia"

GET/api/v1/legionella/trend

National-level year-over-year totals: total cases, population and incidence. Useful for time-series visualisations.

curl -sS "https://123legionella.com/api/v1/legionella/trend"

GET/api/v1/legionella/dataset.json

Full regional dataset as a JSON document. Same payload as /regioni but framed for direct download and reproducible citation.

curl -sS "https://123legionella.com/api/v1/legionella/dataset.json" -o dataset.json

GET/api/v1/legionella/dataset.xml

Full regional dataset as XML, for legacy reporting pipelines and GIS tooling.

curl -sS "https://123legionella.com/api/v1/legionella/dataset.xml" -o dataset.xml

Licence & rate limit

CC BY 4.0 · transparent rate limit

The dataset and the API responses are released under Creative Commons Attribution 4.0 International. Attribution must reference the National Legionella Observatory Italy.

Licence: Creative Commons Attribution 4.0 International (CC BY 4.0).
Rate limit (public tier): 60 requests per minute per IP. Academic partners may request a higher quota.
Attribution string:“Source: National Legionella Observatory Italy (123legionella.com) — CC BY 4.0”.
Stable URLs: Endpoint paths are versioned (/api/v1/); breaking changes will move to /v2.