{"openapi":"3.1.0","info":{"title":"RIS Navernien API","version":"1.0.0","description":"Öffentliche, lesende REST-API. Statische Ressourcen werden bei jedem Deployment aktualisiert. GET und HEAD, keine Anmeldung. Vollständige Listen ohne Pagination; Query-Parameter und Accept-Header filtern oder wechseln das Format nicht. Datumsfelder sind Dokument- bzw. Verfahrensdaten, keine technischen Veröffentlichungszeitpunkte. Fehlende Angaben sind null. Originales LegalDocML.de und das ausdrücklich abgeleitete Navernien-Profil werden unterschieden."},"servers":[{"url":"https://navernien-opendata.vercel.app/api/ris/v1"}],"paths":{"/index.json":{"get":{"summary":"API-Einstieg","responses":{"200":{"description":"API-Einstieg","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Index"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/index.xml":{"get":{"summary":"API-Einstieg im RIS-Metadatenformat","responses":{"200":{"description":"API-Einstieg im RIS-Metadatenformat","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/documents.json":{"get":{"summary":"Alle Dokumente","responses":{"200":{"description":"Alle Dokumente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentCollection"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/documents.xml":{"get":{"summary":"Alle Dokumente im RIS-Metadatenformat","responses":{"200":{"description":"Alle Dokumente im RIS-Metadatenformat","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/laws.json":{"get":{"summary":"Gesetzesfassungen ohne Entwürfe","responses":{"200":{"description":"Gesetzesfassungen ohne Entwürfe","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentCollection"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/laws.xml":{"get":{"summary":"Gesetzesfassungen ohne Entwürfe im RIS-Metadatenformat","responses":{"200":{"description":"Gesetzesfassungen ohne Entwürfe im RIS-Metadatenformat","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/procedures.json":{"get":{"summary":"Alle Vorgänge","responses":{"200":{"description":"Alle Vorgänge","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcedureCollection"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/procedures.xml":{"get":{"summary":"Alle Vorgänge im RIS-Metadatenformat","responses":{"200":{"description":"Alle Vorgänge im RIS-Metadatenformat","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/procedures/{id}.json":{"get":{"summary":"Ein Vorgang mit Verfahrensschritten","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Ein Vorgang mit Verfahrensschritten","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Procedure"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/procedures/{id}.xml":{"get":{"summary":"Ein Vorgang mit Verfahrensschritten im RIS-Metadatenformat","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Ein Vorgang mit Verfahrensschritten im RIS-Metadatenformat","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/documents/{id}.json":{"get":{"summary":"Dokument mit Text, Gliederung und Fassungen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Dokument mit Text, Gliederung und Fassungen","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}},"/documents/{id}.xml":{"get":{"summary":"Unverändertes LegalDocML-XML des Dokuments","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Unverändertes LegalDocML-XML des Dokuments","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"description":"Ressource nicht vorhanden (HTML-Fehlerseite)."}}}}},"components":{"schemas":{"DocumentSummary":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"documentType":{"type":"string"},"rootType":{"enum":["act","bill","doc","documentCollection"]},"status":{"enum":["entwurf","verkuendet","konsolidiert","aufgehoben","dokument"]},"statusLabel":{"type":"string"},"date":{"type":["string","null"],"format":"date"},"number":{"type":["string","null"]},"citation":{"type":["string","null"]},"version":{"type":["string","null"]},"language":{"type":["string","null"]},"country":{"type":["string","null"]},"dateKind":{"enum":["fassung","redaktion"],"description":"Bei redaktion bezeichnet date die Erstellung der redaktionellen Fassung, kein Einreichungsdatum."},"amends":{"type":["string","null"]},"applicants":{"type":"array","items":{"type":"string"}},"effectiveFrom":{"type":["string","null"],"format":"date"},"effectiveTo":{"type":["string","null"],"format":"date"},"workUri":{"type":"string","format":"uri"},"expressionUri":{"type":"string","format":"uri"},"manifestationUri":{"type":"string"},"validation":{"type":"object","properties":{"profile":{"enum":["xsd-1.9","navernien-1"]},"schema":{"type":"string"},"schematron":{"const":false}},"required":["profile","schema","schematron"]},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"html":{"type":"string","format":"uri"},"xml":{"type":"string","format":"uri"}},"required":["self","html","xml"]}},"required":["id","title","documentType","rootType","status","statusLabel","date","number","citation","version","language","country","dateKind","amends","applicants","effectiveFrom","effectiveTo","workUri","expressionUri","manifestationUri","validation","links"]},"Document":{"allOf":[{"$ref":"#/components/schemas/DocumentSummary"},{"type":"object","properties":{"apiVersion":{"const":"1"},"text":{"type":"string"},"contents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"level":{"type":"integer"},"url":{"type":"string","format":"uri"}},"required":["id","label","level","url"]}},"versions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"date":{"type":["string","null"],"format":"date"},"version":{"type":"string"},"statusLabel":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","date","version","statusLabel","url"]}},"procedures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","title","url"]}},"amendments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","title","url"]}}},"required":["apiVersion","text","contents","versions","procedures","amendments"]}]},"ProcedureSummary":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"enum":["eingebracht","beratung","beschlossen","verkuendet","abgelehnt","zurueckgezogen"]},"statusLabel":{"type":"string"},"date":{"type":["string","null"],"format":"date"},"number":{"type":["string","null"]},"legislature":{"type":["string","null"]},"summary":{"type":["string","null"]},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"html":{"type":"string","format":"uri"},"xml":{"type":"string","format":"uri"},"rss":{"type":"string","format":"uri"}},"required":["self","html","xml","rss"]}},"required":["id","title","status","statusLabel","date","number","legislature","summary","links"]},"Procedure":{"allOf":[{"$ref":"#/components/schemas/ProcedureSummary"},{"type":"object","properties":{"apiVersion":{"const":"1"},"relatedDocuments":{"type":"array","items":{"$ref":"#/components/schemas/DocumentSummary"}},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"date":{"type":"string","format":"date"},"institution":{"type":["string","null"]},"description":{"type":["string","null"]},"documentIds":{"type":"array","items":{"type":"string"}},"documents":{"type":"array","items":{"$ref":"#/components/schemas/DocumentSummary"}}},"required":["id","title","date","institution","description","documentIds","documents"]}}},"required":["apiVersion","relatedDocuments","steps"]}]},"DocumentCollection":{"type":"object","properties":{"apiVersion":{"const":"1"},"total":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/DocumentSummary"}}},"required":["apiVersion","total","items"]},"ProcedureCollection":{"type":"object","properties":{"apiVersion":{"const":"1"},"total":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProcedureSummary"}}},"required":["apiVersion","total","items"]},"Index":{"type":"object","properties":{"apiVersion":{"const":"1"},"title":{"type":"string"},"readOnly":{"const":true},"documentation":{"type":"string","format":"uri"},"links":{"type":"object","properties":{"documents":{"type":"string","format":"uri"},"laws":{"type":"string","format":"uri"},"procedures":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"rss":{"type":"string","format":"uri"}},"required":["documents","laws","procedures","openapi","rss"]}},"required":["apiVersion","title","readOnly","documentation","links"]}}},"externalDocs":{"url":"https://navernien-opendata.vercel.app/recht/schnittstellen/"}}