{"openapi":"3.1.0","info":{"title":"Cisco Lab API – Dati e calcoli italiani","version":"1.0.0","description":"Italian rules and formulas as an API: national holidays, working days, formal checks of codice fiscale, partita IVA and IBAN, VAT, lira to euro, mortgage payment, statutory interest (art. 1284 c.c.). Every answer cites the law, the method, the date and the version. No external data, nothing stored. Informazione elaborata automaticamente da fonti pubbliche. Non è consulenza fiscale, legale o tecnica né una perizia. Fanno fede gli atti e le pubblicazioni ufficiali degli enti indicati. Controllare il risultato prima di usarlo per un pagamento, un contratto o un atto. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings."},"servers":[{"url":"https://api.cisco-lab.com/dati"}],"paths":{"/v1/holidays":{"get":{"summary":"Festività nazionali italiane di un anno (Pasqua calcolata, 4 ottobre dal 2026) · Italian national holidays of a year (free)","description":"Source: L. 27/5/1949 n. 260 e successive modifiche; L. 151/2025 per il 4 ottobre (dal 2026). Patrono solo se indicato da chi chiama.. Method: calendar-v1 (Pasqua: algoritmo di Meeus/Jones/Butcher). Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"429":{"description":"Too many requests"}},"parameters":[{"name":"year","in":"query","required":true,"description":"Year (2001-2100)","schema":{"type":"integer","minimum":2001,"maximum":2100},"example":"2026"}]}},"/v1/calendar/is-working-day":{"get":{"summary":"Dice se una data è un giorno lavorativo in Italia · Is a date a working day in Italy (free)","description":"Source: L. 27/5/1949 n. 260 e successive modifiche; L. 151/2025 per il 4 ottobre (dal 2026). Patrono solo se indicato da chi chiama.. Method: calendar-v1. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"429":{"description":"Too many requests"}},"parameters":[{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD (2001-2100)","schema":{"type":"string","format":"date"},"example":"2026-12-08"},{"name":"patron","in":"query","required":false,"description":"Optional: day of the local patron saint, MM-DD (e.g. 06-29 for Rome). Counted as a holiday.","schema":{"type":"string"},"example":"06-29"},{"name":"saturday_is_working","in":"query","required":false,"description":"Optional: true if Saturday is a working day (default false).","schema":{"type":"boolean"},"example":"false"}]}},"/v1/calendar/working-days":{"get":{"summary":"Giorni lavorativi tra due date incluse (lun-ven, esclusi i festivi) · Working days between two dates ($0.01, x402)","description":"Source: L. 27/5/1949 n. 260 e successive modifiche; L. 151/2025 per il 4 ottobre (dal 2026). Patrono solo se indicato da chi chiama.. Method: calendar-v1. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.01","parameters":[{"name":"from","in":"query","required":true,"description":"First day, included (YYYY-MM-DD)","schema":{"type":"string","format":"date"},"example":"2026-12-01"},{"name":"to","in":"query","required":true,"description":"Last day, included (YYYY-MM-DD), at most 10 years after from","schema":{"type":"string","format":"date"},"example":"2026-12-31"},{"name":"patron","in":"query","required":false,"description":"Optional: day of the local patron saint, MM-DD (e.g. 06-29 for Rome). Counted as a holiday.","schema":{"type":"string"},"example":"06-29"},{"name":"saturday_is_working","in":"query","required":false,"description":"Optional: true if Saturday is a working day (default false).","schema":{"type":"boolean"},"example":"false"}]}},"/v1/calendar/add-working-days":{"get":{"summary":"Data dopo N giorni lavorativi (il giorno di partenza non conta) · Date after N working days ($0.01, x402)","description":"Source: L. 27/5/1949 n. 260 e successive modifiche; L. 151/2025 per il 4 ottobre (dal 2026). Patrono solo se indicato da chi chiama.. Method: calendar-v1. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.01","parameters":[{"name":"date","in":"query","required":true,"description":"Start date (YYYY-MM-DD), not counted","schema":{"type":"string","format":"date"},"example":"2026-12-23"},{"name":"days","in":"query","required":true,"description":"Working days to add (1-1000)","schema":{"type":"integer","minimum":1,"maximum":1000},"example":"2"},{"name":"patron","in":"query","required":false,"description":"Optional: day of the local patron saint, MM-DD (e.g. 06-29 for Rome). Counted as a holiday.","schema":{"type":"string"},"example":"06-29"},{"name":"saturday_is_working","in":"query","required":false,"description":"Optional: true if Saturday is a working day (default false).","schema":{"type":"boolean"},"example":"false"}]}},"/v1/check/codice-fiscale":{"post":{"summary":"Codice fiscale: validità formale, carattere di controllo, omocodia, data di nascita, sesso, codice catastale · Italian tax code check (POST only) ($0.005, x402)","description":"Source: D.M. 23/12/1976 (struttura e carattere di controllo del codice fiscale). Method: cf-check-v1. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.005","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["codice_fiscale"],"properties":{"codice_fiscale":{"type":"string","minLength":16,"maxLength":16,"description":"The 16-character tax code, in the JSON body. Never in the URL."}}}}}}}},"/v1/check/partita-iva":{"post":{"summary":"Partita IVA: controllo formale della cifra di controllo · Italian VAT number format check (POST only) ($0.005, x402)","description":"Source: Cifra di controllo della partita IVA (algoritmo pubblico, D.M. 23/12/1976). Method: piva-check-v1. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.005","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["piva"],"properties":{"piva":{"type":"string","minLength":11,"maxLength":20,"description":"11 digits, optional IT prefix, in the JSON body. Never in the URL."}}}}}}}},"/v1/check/iban":{"post":{"summary":"IBAN: cifre di controllo mod 97 e lunghezza del paese (IT = 27) · IBAN check (POST only) ($0.005, x402)","description":"Source: ISO 13616 (IBAN), ISO 7064 mod 97-10. Method: iban-check-v1. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.005","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["iban"],"properties":{"iban":{"type":"string","minLength":15,"maxLength":50,"description":"IBAN, spaces allowed, in the JSON body. Never in the URL."}}}}}}}},"/v1/calc/vat":{"get":{"summary":"IVA: aggiunta o scorporo con aliquota 4, 5, 10 o 22% · Italian VAT add or extract ($0.01, x402)","description":"Source: D.P.R. 26/10/1972 n. 633 (art. 16 e Tabella A). Method: vat-v1 (arrotondamento al centesimo). Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.01","parameters":[{"name":"amount","in":"query","required":true,"description":"Amount in euro (dot as decimal separator)","schema":{"type":"number"},"example":"100"},{"name":"rate","in":"query","required":true,"description":"VAT rate %","schema":{"type":"integer","enum":[4,5,10,22]},"example":"22"},{"name":"mode","in":"query","required":true,"description":"add = amount is net; extract = amount includes VAT","schema":{"type":"string","enum":["add","extract"]},"example":"add"}]}},"/v1/calc/lire-euro":{"get":{"summary":"Lire in euro al cambio fisso 1936,27 (senza rivalutazione) · Italian lira to euro ($0.01, x402)","description":"Source: Regolamento (CE) n. 2866/98 del Consiglio (1 euro = 1936,27 lire). Method: lire-v1. Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.01","parameters":[{"name":"lire","in":"query","required":true,"description":"Amount in lire (whole number)","schema":{"type":"integer","minimum":1},"example":"1936270"}]}},"/v1/calc/mortgage":{"get":{"summary":"Mutuo: rata costante alla francese e piano sintetico per anno (max 40 anni) · Mortgage payment and yearly schedule ($0.01, x402)","description":"Source: Ammortamento alla francese (rata costante), formula matematica. Method: mortgage-v1 (rate mensili posticipate). Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.01","parameters":[{"name":"principal","in":"query","required":true,"description":"Loan amount in euro","schema":{"type":"number"},"example":"100000"},{"name":"annual_rate","in":"query","required":true,"description":"Nominal annual rate (TAN) %","schema":{"type":"number","minimum":0,"maximum":30},"example":"3"},{"name":"years","in":"query","required":true,"description":"Duration in years (1-40)","schema":{"type":"integer","minimum":1,"maximum":40},"example":"20"}]}},"/v1/calc/legal-interest":{"get":{"summary":"Interessi legali (art. 1284 c.c.) tra due date, spezzati a ogni cambio di tasso (tassi dal 2010) · Italian statutory interest ($0.01, x402)","description":"Source: Art. 1284 c.c.; decreti annuali del Ministro dell'economia e delle finanze (vedi periods[].act). Method: legal-interest-v1 (interesse semplice, dal giorno dopo \"from\" a \"to\" incluso). Automatically processed information from public sources. Not tax, legal or technical advice, nor an appraisal. Official acts and publications of the listed bodies prevail. Verify before use in payments, contracts or filings.","responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Bad parameters (free, never charged)"},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"},"429":{"description":"Too many requests"}},"x-x402-price":"$0.01","parameters":[{"name":"amount","in":"query","required":true,"description":"Principal in euro","schema":{"type":"number"},"example":"10000"},{"name":"from","in":"query","required":true,"description":"Start date (YYYY-MM-DD); interest from the next day. From 2010-01-01","schema":{"type":"string","format":"date"},"example":"2023-07-01"},{"name":"to","in":"query","required":true,"description":"End date, included (YYYY-MM-DD), at most 2026-12-31","schema":{"type":"string","format":"date"},"example":"2024-06-30"},{"name":"day_count","in":"query","required":false,"description":"Optional: 365 (default) or actual (366 in leap years)","schema":{"type":"string","enum":["365","actual"]},"example":"365"}]}}}}