{"openapi":"3.0.3","info":{"title":"Gnist Context — Finlex (Finnish Legislation)","description":"Finnish legislation — statutes, consolidated laws, and government proposals from Finlex open data.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/finlex/`\n- **Toolkit page:** `/toolkits/finlex`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/finlex/list_statutes":{"post":{"tags":["Legal"],"summary":"list_statutes","description":"List Finnish statutes from the Statute Book of Finland (Suomen Saadoskokoelma).\n\nBrowse recently published statutes or filter by year. Each statute is identified\nby year and number (e.g. 2026/1). Use get_statute to retrieve full text.\n\nReturns:\n    Dict with 'count', 'page', and 'statutes' list.","operationId":"finlex_list_statutes","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by year (e.g. 2025)"},"language":{"default":"fin","description":"Language: 'fin' (Finnish, default), 'swe' (Swedish)","type":"string"},"page":{"default":1,"description":"Page number (default 1)","minimum":1,"type":"integer"},"limit":{"default":20,"description":"Results per page (default 20, max 50)","maximum":50,"minimum":1,"type":"integer"}},"type":"object"}}}}}},"/rest/finlex/get_statute":{"post":{"tags":["Legal"],"summary":"get_statute","description":"Retrieve a specific Finnish statute with full text and article structure.\n\nReturns the statute's metadata (title, dates, ELI identifier) and its articles\nwith section numbers, headings, and content parsed from Akoma Ntoso XML.\n\nReturns:\n    Statute detail dict, or error if not found.","operationId":"finlex_get_statute","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"description":"Year of the statute (e.g. 2025)","type":"integer"},"number":{"description":"Statute number within the year (e.g. '1', '118')","type":"string"},"language":{"default":"fin","description":"Language: 'fin' (Finnish, default), 'swe' (Swedish)","type":"string"}},"required":["year","number"],"type":"object"}}}}}},"/rest/finlex/list_government_proposals":{"post":{"tags":["Legal"],"summary":"list_government_proposals","description":"List Finnish government proposals (hallituksen esitykset / HE).\n\nGovernment proposals are bills submitted by the Finnish government to Parliament.\nThey contain the reasoning and draft legislation for proposed changes.\n\nReturns:\n    Dict with 'count', 'page', and 'proposals' list.","operationId":"finlex_list_government_proposals","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by year (e.g. 2025)"},"language":{"default":"fin","description":"Language: 'fin' (Finnish, default), 'swe' (Swedish)","type":"string"},"page":{"default":1,"description":"Page number (default 1)","minimum":1,"type":"integer"},"limit":{"default":20,"description":"Results per page (default 20, max 50)","maximum":50,"minimum":1,"type":"integer"}},"type":"object"}}}}}},"/rest/finlex/get_government_proposal":{"post":{"tags":["Legal"],"summary":"get_government_proposal","description":"Retrieve a specific Finnish government proposal with metadata and content preview.\n\nReturns the proposal's metadata (title, dates, ELI identifier) and a preview\nof the content (first 10 paragraphs).\n\nReturns:\n    Proposal detail dict, or error if not found.","operationId":"finlex_get_government_proposal","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"description":"Year of the proposal (e.g. 2025)","type":"integer"},"number":{"description":"Proposal number within the year (e.g. '8')","type":"string"},"language":{"default":"fin","description":"Language: 'fin' (Finnish, default), 'swe' (Swedish)","type":"string"}},"required":["year","number"],"type":"object"}}}}}},"/rest/finlex/list_consolidated_statutes":{"post":{"tags":["Legal"],"summary":"list_consolidated_statutes","description":"List consolidated (updated/amended) Finnish statutes.\n\nConsolidated statutes reflect the current version of the law with all amendments\napplied. Use this instead of list_statutes when you need the up-to-date text.\n\nReturns:\n    Dict with 'count', 'page', and 'statutes' list.","operationId":"finlex_list_consolidated_statutes","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by year (e.g. 2025)"},"language":{"default":"fin","description":"Language: 'fin' (Finnish, default), 'swe' (Swedish)","type":"string"},"page":{"default":1,"description":"Page number (default 1)","minimum":1,"type":"integer"},"limit":{"default":20,"description":"Results per page (default 20, max 50)","maximum":50,"minimum":1,"type":"integer"}},"type":"object"}}}}}},"/rest/finlex/get_consolidated_statute":{"post":{"tags":["Legal"],"summary":"get_consolidated_statute","description":"Retrieve a specific consolidated Finnish statute with full amended text.\n\nReturns the current version of the statute with all amendments applied,\nincluding metadata and article structure.\n\nReturns:\n    Statute detail dict, or error if not found.","operationId":"finlex_get_consolidated_statute","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"year":{"description":"Year of the statute (e.g. 2024)","type":"integer"},"number":{"description":"Statute number within the year (e.g. '2')","type":"string"},"language":{"default":"fin","description":"Language: 'fin' (Finnish, default), 'swe' (Swedish)","type":"string"}},"required":["year","number"],"type":"object"}}}}}},"/rest/finlex/report_feedback":{"post":{"tags":["Legal"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"finlex_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Legal","description":"Data sources: Legal"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}