Legal

Data source: PRH (Patentti- ja rekisterihallitus / Finnish Patent and Registration Office)

REST Bridge Endpoint https://context.gnist.ai/rest/prh/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (4)

lookup_prh_company
search_prh_companies
get_prh_financial_periods
report_feedback

lookup_prh_company

Look up a Finnish company by its business ID (Y-tunnus).

Returns company details including name, legal form, industry, registration
date, trade register status, website, and addresses.

Args:
business_id: Finnish business ID (Y-tunnus) in format "1234567-8".

Returns:
Company record, or {"error": "not_found"} if the business ID is unknown.

Parameter	Type	Required	Description
`business_id`	`string`	required	Finnish business ID (Y-tunnus) — format "1234567-8" (e.g. "0112038-9" for Nokia).

Request Body

{
  "business_id": "example"
}

search_prh_companies

Search the Finnish Trade Register by name, location, company form, or industry.

At least one search parameter must be provided. Returns matching companies
from PRH (Patentti- ja rekisterihallitus) open data.

Args:
name: Company name or partial name to search for.
location: Town or city in Finland.
company_form: Company form code (OY, OYJ, KY, OK, AY, etc.).
business_line: TOL 2008 industry code or description text.
max_results: Maximum number of results to return (1-50, default 10).

Returns:
Object with count, total available results, and list of company records.

Parameter	Type	Required	Description
`name`	`any`	optional	Company name or partial name to search for.
`location`	`any`	optional	Town or city (e.g. 'Helsinki', 'Espoo', 'Tampere').
`company_form`	`any`	optional	Company form code: 'OY' (private limited), 'OYJ' (public limited), 'KY' (limited partnership), 'OK' (cooperative), 'AY' (general partnership).
`business_line`	`any`	optional	TOL 2008 industry code or text (e.g. '62010' for software development).
`max_results`	`integer`	optional	Maximum number of results to return (1-50, default 10). (default: 10)

Request Body

{
  "query": "example"
}

get_prh_financial_periods

List available digital financial statement periods for a Finnish company.

Returns the filing dates for which PRH has received digital financial
statements (XBRL format). Use this to check what financial data is
available before requesting specific statements.

Args:
business_id: Finnish business ID (Y-tunnus).

Returns:
Object with count and list of available financial periods.

Parameter	Type	Required	Description
`business_id`	`string`	required	Finnish business ID (Y-tunnus) — format "1234567-8".

Request Body

{
  "business_id": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/prh/lookup_prh_company" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"business_id": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/prh/lookup_prh_company",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "business_id": "example"
},
)
print(resp.json())