{"openapi": "3.1.0", "info": {"title": "LETZDATA open API (concept)", "version": "0.2.0", "description": "Search the LETZDATA catalogue, read access rules, find partner services and draft one application. A person hands a draft over to MyGuichet, where they log in and sign; agents cannot. The catalogue is the real Public Sector Data Catalogue (snapshot) with a few marked sample datasets; open data is all of data.public.lu. The same operations are available to agents as an MCP server at https://letzdata.neoninet.com/mcp."}, "servers": [{"url": "https://letzdata.neoninet.com"}], "paths": {"/api/datasets": {"get": {"operationId": "searchDatasets", "summary": "Search datasets", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}}, {"name": "theme", "in": "query", "schema": {"type": "string", "enum": ["HEAL", "ENVI", "TRAN", "EDUC", "ENER", "ECON", "SOCI", "REGI", "GOVE"]}}, {"name": "access", "in": "query", "schema": {"type": "string", "enum": ["any", "open", "application"]}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "maximum": 50}}], "responses": {"200": {"description": "Matching datasets", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/datasets/{id}": {"get": {"operationId": "getDatasetCard", "summary": "Dataset card: contents, collection, limits, citation, uses and models", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Dataset", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "Unknown id"}}}}, "/api/datasets/{id}/access": {"get": {"operationId": "getAccessRules", "summary": "Access rules of a dataset", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Rules", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "Unknown id"}}}}, "/api/open": {"get": {"operationId": "searchOpenData", "summary": "Every open dataset on data.public.lu: search, filter by publisher, page", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}}, {"name": "publisher", "in": "query", "schema": {"type": "string"}, "description": "Name, acronym or data.public.lu id"}, {"name": "page", "in": "query", "schema": {"type": "integer", "minimum": 1}}, {"name": "page_size", "in": "query", "schema": {"type": "integer", "maximum": 100}}], "responses": {"200": {"description": "Matching open datasets and their total", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/open/publishers": {"get": {"operationId": "listPublishers", "summary": "Every publisher on data.public.lu, with its number of datasets and reuses", "responses": {"200": {"description": "Publishers", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/public/{id}": {"get": {"operationId": "previewOpenData", "summary": "Real open data: metadata and first rows of a data.public.lu dataset, read live", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}, "description": "data.public.lu dataset id"}], "responses": {"200": {"description": "Metadata, licence and up to six rows of one file", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "Unknown on data.public.lu"}, "429": {"description": "Too many previews"}}}}, "/api/services": {"get": {"operationId": "findPartnerServices", "summary": "Partner services by project stage", "parameters": [{"name": "stage", "in": "query", "schema": {"type": "string", "enum": ["guidage-donnees-projet", "decouverte-donnees", "demande-access", "preparation-donnees", "combinaison-donnees", "reutilisation-donnees", "resultats-sortie-donnees"]}}, {"name": "q", "in": "query", "schema": {"type": "string"}}], "responses": {"200": {"description": "Services", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/applications": {"post": {"operationId": "draftApplication", "summary": "Draft one application (draft only)", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["title", "datasets"], "properties": {"title": {"type": "string"}, "purpose": {"type": "string", "enum": ["research", "innovation", "policy", "statistics", "ai"]}, "datasets": {"type": "array", "items": {"type": "string"}}, "partners": {"type": "array", "items": {"type": "string"}}}}}}}, "responses": {"201": {"description": "Draft with review_url for the person", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Invalid"}}}}, "/api/applications/{id}": {"get": {"operationId": "applicationStatus", "summary": "State of a draft (after handover, the status lives in MyGuichet)", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Status", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "Unknown id"}}}}}}