Tools (4)

lookup_bolagsverket_company
search_bolagsverket_companies
get_bolagsverket_changes
report_feedback

lookup_bolagsverket_company

Look up a Swedish company by its organisation number in Bolagsverket.

Returns company record including name, organisation form, legal form,
registration date, business description, SNI industry codes, postal address,
active/deregistration status, and any ongoing proceedings (bankruptcy,
liquidation).

Data sourced from Bolagsverket (Swedish Companies Registration Office) and
SCB (Statistics Sweden) via the VärdefullaDatamängder API.

Args:
org_number: Swedish organisation number — 10 digits.

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

Parameter	Type	Required	Description
`org_number`	`string`	required	Swedish organisation number — 10 digits, with or without hyphen (e.g. "5564866993", "556486-6993").

Request Body

{
  "org_number": "123456789"
}

search_bolagsverket_companies

Search Swedish companies by name in the Bolagsverket bulk-data cache.

Returns matching companies from the locally cached Bolagsverket and SCB
bulk files. Searches company name and alternate names (case-insensitive).

Args:
name: Company name or partial name to search for.
limit: Maximum results (default 20, max 100).

Returns:
Object with count and results list.

Parameter	Type	Required	Description
`name`	`string`	required	Company name to search for (at least 2 characters).
`limit`	`integer`	optional	Maximum number of results to return (1–100). (default: 20)

Request Body

{
  "name": "example"
}

get_bolagsverket_changes

Get recent changes to Swedish company data from Bolagsverket.

Returns field-level diffs (before/after values) for companies whose
data changed between ETL runs. Changes are detected by comparing
weekly bulk-file snapshots from Bolagsverket and SCB.

Tracks: name changes, address changes, status changes (deregistration,
liquidation), industry code (SNI) changes, and legal form changes.

Args:
since: ISO 8601 timestamp — return changes captured after this time.
limit: Maximum number of changes to return (1–100, default 50).

Returns:
Object with count and list of change records, each containing
entity_id (org number), changed_at timestamp, and a list of
field changes with before/after values.

Parameter	Type	Required	Description
`since`	`string`	required	ISO 8601 timestamp — return changes captured after this time (e.g. "2026-04-01T00:00:00Z").
`limit`	`integer`	optional	Maximum number of changes to return (1–100, default 50). (default: 50)

Request Body

{
  "since": "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/bolagsverket/lookup_bolagsverket_company" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"org_number": "example"}'

Python

import httpx

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