{"openapi":"3.0.3","info":{"title":"Gnist Context — PRH (Finnish Company Registry)","description":"Finnish company registry — business details, legal form, industry codes, financial statement periods from PRH open data.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/prh/`\n- **Toolkit page:** `/toolkits/prh`\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/prh/lookup_prh_company":{"post":{"tags":["Legal"],"summary":"lookup_prh_company","description":"Look up a Finnish company by its business ID (Y-tunnus).\n\nReturns company details including name, legal form, industry, registration\ndate, trade register status, website, and addresses.\n\nArgs:\n    business_id: Finnish business ID (Y-tunnus) in format \"1234567-8\".\n\nReturns:\n    Company record, or {\"error\": \"not_found\"} if the business ID is unknown.","operationId":"prh_lookup_prh_company","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":{"business_id":{"description":"Finnish business ID (Y-tunnus) — format \"1234567-8\" (e.g. \"0112038-9\" for Nokia).","type":"string"}},"required":["business_id"],"type":"object"}}}}}},"/rest/prh/search_prh_companies":{"post":{"tags":["Legal"],"summary":"search_prh_companies","description":"Search the Finnish Trade Register by name, location, company form, or industry.\n\nAt least one search parameter must be provided. Returns matching companies\nfrom PRH (Patentti- ja rekisterihallitus) open data.\n\nArgs:\n    name: Company name or partial name to search for.\n    location: Town or city in Finland.\n    company_form: Company form code (OY, OYJ, KY, OK, AY, etc.).\n    business_line: TOL 2008 industry code or description text.\n    max_results: Maximum number of results to return (1-50, default 10).\n\nReturns:\n    Object with count, total available results, and list of company records.","operationId":"prh_search_prh_companies","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":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Company name or partial name to search for."},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Town or city (e.g. 'Helsinki', 'Espoo', 'Tampere')."},"company_form":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Company form code: 'OY' (private limited), 'OYJ' (public limited), 'KY' (limited partnership), 'OK' (cooperative), 'AY' (general partnership)."},"business_line":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"TOL 2008 industry code or text (e.g. '62010' for software development)."},"max_results":{"default":10,"description":"Maximum number of results to return (1-50, default 10).","type":"integer"}},"type":"object"}}}}}},"/rest/prh/get_prh_financial_periods":{"post":{"tags":["Legal"],"summary":"get_prh_financial_periods","description":"List available digital financial statement periods for a Finnish company.\n\nReturns the filing dates for which PRH has received digital financial\nstatements (XBRL format). Use this to check what financial data is\navailable before requesting specific statements.\n\nArgs:\n    business_id: Finnish business ID (Y-tunnus).\n\nReturns:\n    Object with count and list of available financial periods.","operationId":"prh_get_prh_financial_periods","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":{"business_id":{"description":"Finnish business ID (Y-tunnus) — format \"1234567-8\".","type":"string"}},"required":["business_id"],"type":"object"}}}}}},"/rest/prh/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":"prh_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."}}}}