Skip to content
Documentation

Documentation

Connect Bolagsdelta to your AI tool and to your own systems.

MCP for AI tools

Read company data, report changes and watches in your AI tool. All tools are read-only. MCP address:

https://mcp.bolagsdelta.se/mcp

How to connect →

REST API

The API returns the same data as the website, as JSON. Base address:

https://api.bolagsdelta.se

Authentication

Send your API key in the X-API-Key header, or as a bearer token. The key is shown once when we issue it.

curl -H "X-API-Key: cw_<prefix>_<secret>" \
  "https://api.bolagsdelta.se/api/v1/companies?q=volvo"

Common calls

  • GET /api/v1/companies?q=: search companies by name or organisation number
  • GET /api/v1/companies/{orgnr}: company with register facts, filings and latest key figures
  • GET /api/v1/companies/{orgnr}/financials: key figures over time with source references
  • GET /api/v1/companies/{orgnr}/diffs/latest: what changed between the two latest reports
  • GET /api/v1/companies/{orgnr}/signals: signals with evidence for one company

Limits and errors

  • Open calls without a key: 120 per minute per IP address.
  • Calls with a valid key: 600 per minute per organisation. Document calls: 30 per minute.
  • Errors are returned as JSON with message_sv, message_en and error_code. When there are too many calls the API answers 429 with a Retry-After header.

Webhooks

Alert rules you create through the API (POST /api/v1/workspace/rules) can use the webhook channel with an https address. Webhooks require Pro or higher.

API keys are issued by us for the API plan. Contact [email protected] to get started.

Source: Bolagsverket and SCB, own processing. Every answer carries a source reference.