Italian public holidays API

One endpoint to tell whether a given day is a working day in an Italian municipality, accounting for national holidays and the local patron saint's day. Covers all 7,904 ISTAT municipalities, 5,617 of them carrying the date from the town's own record rather than an inferred one.

Why it exists

The liturgical calendar tells you when a saint is celebrated, not when a town shuts. Saint Paul is 29 June, but in Aversa the patronal holiday falls on 25 January. Every date here is the civic one, taken town by town, never inferred from the saint.

Base URL

https://festivitaitalia.com

Endpoints

GET /v1/comuni?q=berg

Look up a municipality by name and get its ISTAT code. Everything else starts here.

Try it

GET /v1/festivita?comune=016024&anno=2026

Every holiday of the year for that municipality, national and patronal, merged when they fall on the same day.

Try it

Response

{
  "comune": {
    "codice": "016024",
    "nome": "Bergamo",
    "sigla": "BG",
    "regione": "Lombardia",
    "slug": "bergamo-bg",
    "patroni": [{ "santo": "sant'Alessandro di Bergamo", "data": "08-26" }]
  },
  "anno": 2026,
  "festivita": [
    { "data": "2026-01-01", "nome": "Capodanno", "tipo": "nazionale" },
    { "data": "2026-04-06", "nome": "Lunedì dell'Angelo", "tipo": "nazionale" },
    { "data": "2026-08-26", "nome": "Patrono: sant'Alessandro di Bergamo", "tipo": "patrono" },
    { "data": "2026-10-04", "nome": "San Francesco d'Assisi", "tipo": "nazionale" }
  ]
}

GET /v1/giorno-lavorativo?comune=016024&data=2026-08-26

Tells you whether that day is a working day, and if not why. Returns { "lavorativo": false, "motivo": "Patrono: sant'Alessandro di Bergamo" }.

Try it

GET /v1/prossimo-lavorativo?comune=016024&data=2026-12-24

The first working day after the given date.

Try it

GET /v1/aggiungi-lavorativi?comune=016024&data=2026-12-24&giorni=3

Adds N working days to a date. This is the call an online shop needs to estimate delivery.

Try it

GET /v1/ical/016024.ics

iCal feed with this year's and next year's holidays, subscribable from any calendar app.

Try it

Shared parameters

comune is always the six-digit ISTAT code, which you get from /v1/comuni. Dates use YYYY-MM-DD. Add &sabato=true if Saturday counts as a working day for your business.

Errors

Errors return status 400 or 404 with a JSON body holding a single errore key describing what is missing. Error messages are in Italian.

Limits and pricing

The API is free and needs no key while it is getting started. Responses are cached for an hour and CORS is open, so you can call it straight from the browser. For high volume, a service guarantee, or the full dataset as a CSV under an annual licence, get in touch.

Stated accuracy

Against an independent source, 259 municipalities agreed on 94.2% of dates. Municipalities whose date is inferred from the liturgical calendar rather than read from the town's own record are kept out of the public pages but stay queryable. Report an error and it gets fixed the same day.

Where the data comes from

Patrons and dates from the Italian Wikipedia municipality infoboxes (CC BY-SA 4.0), municipality-to-article links from Wikidata (CC0), the municipality list from ISTAT codes. National holidays follow law 260/1949 and its amendments, including law 151/2025 which brings back 4 October from 2026. Attribution is required when reusing this data.

Get in touch

Integrations, licensing and corrections: ook71654@gmail.com