{"openapi":"3.1.0","info":{"title":"OpenLegis — API pubblica / public API","description":"**IT** — API **read-only** sui dati aperti di OpenLegis: knowledge graph delle relazioni tra norme, elenco e dettaglio delle norme (testo per-articolo) e relazioni di modifica. Solo letture (GET). Fonti pubbliche e citabili (ELI). I nomi legali (es. 'Codice Penale') restano in italiano per la citabilità; usa `?lang=en` o l'header `Accept-Language: en` per la prosa in inglese. CC BY 4.0 — Fonte: Normattiva (Akoma Ntoso, ELI). Strumento informativo, non consulenza legale.\n\n**EN** — **Read-only** API over OpenLegis open data: knowledge graph of relations between legal acts, list and detail of acts (per-article text) and amendment relations. Reads only (GET). Public, citable sources (ELI). Italian legal names (e.g. 'Codice Penale') are kept in Italian for citability; pass `?lang=en` or `Accept-Language: en` for English prose. CC BY 4.0 — Source: Normattiva (Akoma Ntoso, ELI). Informational tool, not legal advice.","contact":{"name":"OpenLegis","url":"https://openlegis.it/","email":"hello@openlegis.it"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"version":"1.0.0"},"paths":{"/api/public/health":{"get":{"tags":["meta"],"summary":"Stato del servizio / service status","operationId":"health_api_public_health_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/norme":{"get":{"tags":["norme"],"summary":"Elenco delle norme del corpus / list of acts","operationId":"lista_norme_api_public_norme_get","parameters":[{"name":"tipo","in":"query","required":false,"schema":{"type":"string","description":"filtra per tipo ELI (es. legge, decreto-legge, decreto-legislativo)","default":"","title":"Tipo"},"description":"filtra per tipo ELI (es. legge, decreto-legge, decreto-legislativo)"},{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"ricerca testuale nel titolo","default":"","title":"Q"},"description":"ricerca testuale nel titolo"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/norme/{eli}":{"get":{"tags":["norme"],"summary":"Dettaglio di una norma (testo per-articolo + relazioni) / act detail","operationId":"dettaglio_norma_api_public_norme__eli__get","parameters":[{"name":"eli","in":"path","required":true,"schema":{"type":"string","title":"Eli"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/relazioni":{"get":{"tags":["relazioni"],"summary":"Relazioni di modifica di una norma / amendment relations of an act","operationId":"relazioni_api_public_relazioni_get","parameters":[{"name":"norma","in":"query","required":true,"schema":{"type":"string","description":"ELI o testo libero (es. 'eli:/it/decreto-legge/2024/03/02/19' o 'DL 19/2024')","title":"Norma"},"description":"ELI o testo libero (es. 'eli:/it/decreto-legge/2024/03/02/19' o 'DL 19/2024')"},{"name":"dir","in":"query","required":false,"schema":{"type":"string","pattern":"^(out|in|entrambe)$","description":"out=cosa modifica · in=da chi è modificata","default":"entrambe","title":"Dir"},"description":"out=cosa modifica · in=da chi è modificata"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/graph":{"get":{"tags":["grafo"],"summary":"Knowledge graph delle relazioni (nodi + archi) / relations knowledge graph","operationId":"graph_api_public_graph_get","parameters":[{"name":"livello","in":"query","required":false,"schema":{"type":"string","pattern":"^(norma|articolo)$","description":"aggregazione: per norma o per articolo","default":"norma","title":"Livello"},"description":"aggregazione: per norma o per articolo"},{"name":"max_nodi","in":"query","required":false,"schema":{"type":"integer","maximum":20000,"minimum":10,"default":2000,"title":"Max Nodi"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/pnrr/graph":{"get":{"tags":["pnrr"],"summary":"Grafo aziende↔appalti PNRR, filtrato e limitato server-side / PNRR contracts graph","operationId":"pnrr_graph_api_public_pnrr_graph_get","parameters":[{"name":"settore","in":"query","required":false,"schema":{"type":"string","description":"filtra per settore CUP (sottostringa, case-insensitive)","default":"","title":"Settore"},"description":"filtra per settore CUP (sottostringa, case-insensitive)"},{"name":"importo_min","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"importo minimo del progetto (finanziamento_totale)","default":0,"title":"Importo Min"},"description":"importo minimo del progetto (finanziamento_totale)"},{"name":"max_nodi","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":10,"default":500,"title":"Max Nodi"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/pnrr/classifica-aziende":{"get":{"tags":["pnrr"],"summary":"Classifica aziende per importo appalti PNRR vinti / companies ranked by awarded amount","operationId":"pnrr_classifica_aziende_api_public_pnrr_classifica_aziende_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/pnrr/classifica-enti":{"get":{"tags":["pnrr"],"summary":"Classifica enti appaltanti per numero di appalti PNRR / contracting authorities ranked by count","operationId":"pnrr_classifica_enti_api_public_pnrr_classifica_enti_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/pnrr/classifica-regioni":{"get":{"tags":["pnrr"],"summary":"Classifica regioni per importo progetti PNRR / regions ranked by project value","operationId":"pnrr_classifica_regioni_api_public_pnrr_classifica_regioni_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/pnrr/finanziamenti":{"get":{"tags":["pnrr"],"summary":"Flussi di finanziamento per fonte e settore (dati per un diagramma Sankey) / funding flows by source and sector","operationId":"pnrr_finanziamenti_api_public_pnrr_finanziamenti_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/politici/graph":{"get":{"tags":["politici"],"summary":"Grafo parlamentari↔atti, filtrato e limitato server-side / MPs-bills graph","operationId":"politici_graph_api_public_politici_graph_get","parameters":[{"name":"gruppo","in":"query","required":false,"schema":{"type":"string","description":"filtra per gruppo parlamentare (sottostringa, case-insensitive)","default":"","title":"Gruppo"},"description":"filtra per gruppo parlamentare (sottostringa, case-insensitive)"},{"name":"ramo","in":"query","required":false,"schema":{"type":"string","description":"filtra per ramo: Camera|Senato","default":"","title":"Ramo"},"description":"filtra per ramo: Camera|Senato"},{"name":"max_nodi","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":10,"default":300,"title":"Max Nodi"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/politici/classifica-parlamentari":{"get":{"tags":["politici"],"summary":"Classifica parlamentari per numero di atti firmati / MPs ranked by bills signed","operationId":"politici_classifica_parlamentari_api_public_politici_classifica_parlamentari_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/politici/classifica-gruppi":{"get":{"tags":["politici"],"summary":"Classifica gruppi parlamentari per numero di atti firmati / parliamentary groups ranked by bills signed","operationId":"politici_classifica_gruppi_api_public_politici_classifica_gruppi_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/ddl/lista":{"get":{"tags":["ddl"],"summary":"Tabella comparativa DDL raccolti: stato, date, giorni fermo / bills comparison table","operationId":"ddl_lista_api_public_ddl_lista_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/ddl/{numero}":{"get":{"tags":["ddl"],"summary":"Scheda di un DDL con dossier di conformità (citazioni esplicite nel testo) / bill detail + compliance dossier","operationId":"ddl_dettaglio_api_public_ddl__numero__get","parameters":[{"name":"numero","in":"path","required":true,"schema":{"type":"string","title":"Numero"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"lingua della prosa/disclaimer: it|en","default":"","title":"Lang"},"description":"lingua della prosa/disclaimer: it|en"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}