# Swereg – Sveriges företagsregister som API och MCP

> Svenska företagsuppgifter från Bolagsverket, SCB och digitalt inlämnade årsredovisningar. REST-API (JSON, cursor-paginering, fel enligt RFC 9457) och en MCP-server för AI-assistenter. Företagssidor för människor finns på https://swereg.se/.

## MCP-server
- Adress: https://swereg.com/mcp (Streamable HTTP, protokoll 2026-07-28 och 2025-11-25, utan sessioner)
- Utan inloggning: search_companies, get_company, list_categories, find_similar_companies (20 anrop/minut, 300/dygn per IP)
- Med inloggning (OAuth via Clerk, metadata https://swereg.com/.well-known/oauth-protected-resource/mcp) eller API-nyckel som Bearer: alla verktyg
- search_companies: Sök svenska företag
- get_company: Hämta ett företag
- get_financials: Bokslut per år (kräver inloggning)
- get_key_ratios: Nyckeltal per år (kräver inloggning)
- list_changes: Ändringar i registret (kräver inloggning)
- list_categories: Branscher
- find_similar_companies: Liknande företag
- company_statistics: Statistik över företag (kräver inloggning)

## REST-API
- Bas-URL: https://swereg.com/api/v1
- Autentisering: `Authorization: Bearer bi_live_…` eller `bi_test_…` (32 tecken efter prefixet). Anropa bara från server.
- OpenAPI-spec (sanningskälla): https://swereg.com/openapi.yaml
- Postman-samling: https://swereg.com/postman.json
- Enskilda firmor har `org_nr: null` (personnummer lämnas aldrig ut). Använd `exclude_advertising_blocked=true` vid marknadsföring.

## Dokumentation
- [Översikt](https://swereg.com/docs): Kom igång
- [Snabbstart](https://swereg.com/docs/snabbstart): Kom igång
- [Autentisering](https://swereg.com/docs/autentisering): Kom igång
- [MCP-server](https://swereg.com/docs/mcp): MCP för AI-assistenter
- [Verktyg](https://swereg.com/docs/mcp-verktyg): MCP för AI-assistenter
- [Inloggning och gränser](https://swereg.com/docs/mcp-inloggning): MCP för AI-assistenter
- [Sök och filter](https://swereg.com/docs/sok-och-filter): Använda API:et
- [Paginering](https://swereg.com/docs/paginering): Använda API:et
- [Fält och expand](https://swereg.com/docs/falt-och-expand): Använda API:et
- [Fel](https://swereg.com/docs/fel): Använda API:et
- [Rate limits och planer](https://swereg.com/docs/rate-limits): Använda API:et
- [Byggföretag utan hemsida](https://swereg.com/docs/recept-bygg-utan-hemsida): Recept
- [Växande bolag över 10 mkr](https://swereg.com/docs/recept-vaxande-bolag): Recept
- [Frisörer inom 2 km](https://swereg.com/docs/recept-frisorer-nara): Recept
- [Hela ekonomihistoriken](https://swereg.com/docs/recept-ekonomihistorik): Recept
- [Synka egen databas](https://swereg.com/docs/recept-synka-databas): Recept
- [Exportera till Excel](https://swereg.com/docs/recept-excel): Recept
- [Export](https://swereg.com/docs/export): Funktioner
- [Ändringsflöde](https://swereg.com/docs/andringsflode): Funktioner
- [Webhooks](https://swereg.com/docs/webhooks): Funktioner
- [Koppla ett CRM](https://swereg.com/docs/crm): Integrationer
- [Integritet och reklamspärr](https://swereg.com/docs/integritet): Om datan
- [Datakällor och uppdatering](https://swereg.com/docs/datakallor): Om datan
- [Changelog](https://swereg.com/docs/changelog): Om datan
- [Villkor](https://swereg.com/docs/villkor): Om datan
- [API-referens](https://swereg.com/docs/referens): Referens

## Endpoints
- GET /companies – Sök och filtrera företag
- POST /companies/batch – Hämta upp till 100 företag
- GET /companies/{identifier} – Hämta ett företag
- GET /companies/{identifier}/financials – Bokslutsuppgifter per år
- GET /companies/{identifier}/key-ratios – Nyckeltal med branschmedian
- GET /companies/{identifier}/insights – AI-sammanfattning
- GET /companies/{identifier}/annual-reports – Årsredovisningar
- GET /companies/{identifier}/workplaces – Arbetsställen
- GET /companies/{identifier}/similar – Liknande företag
- GET /autocomplete – Autocomplete
- GET /categories – Kategorier
- GET /categories/{slug} – En kategori
- GET /sni/{code} – SNI-kod
- GET /locations/counties – Län
- GET /locations/municipalities – Kommuner
- GET /stats/companies – Statistik
- GET /benchmarks – Branschmedianer
- GET /me – Ditt konto och din förbrukning
- POST /crm/enrich – Matcha och berika CRM-poster
- POST /changes/query – Ändringar för bevakade företag
- POST /exports – Skapa export
- GET /exports/{id} – Exportstatus
- GET /changes – Ändringsflöde
- GET /webhooks – Lista webhooks
- POST /webhooks – Skapa webhook
- PATCH /webhooks/{id} – Ändra webhook
- DELETE /webhooks/{id} – Ta bort webhook
- POST /webhooks/{id}/rotate-secret – Byt hemlighet
- POST /webhooks/{id}/test – Skicka testhändelse
- GET /webhooks/{id}/deliveries – Leveranser

## Filter för GET /companies
- q (string): Fritext som matchar namn, bransch och org.nr (max 200 tecken).
- category (string): Kommaseparerade kategori-sluggar, inkluderar underkategorier.
- sni (string): Kommaseparerade SNI-prefix.
- county (string): Län.
- municipality (string): Kommun.
- city (string): Postort.
- postal_code (string): Postnummer-prefix, 1–5 siffror.
- legal_form (string): Bolagsform.
- status (string): Företagsstatus. Standard är aktiv.
- website_status (enum): Hemsidestatus. Kräver behörigheten websites:read.
- has_financials (boolean): Bara företag med ekonomidata.
- has_email (boolean): Bara företag som angett e-post (false: bara de som saknar).
- has_phone (boolean): Bara företag som angett telefon (false: bara de som saknar).
- employees_class (string): Storleksklass för antal anställda enligt SCB: 0, 1-4, 5-9, 10-19, 20-49, 50-99, 100-199, 200-499, 500-999, 1000-1499, 1500-1999, 2000-2999, 3000-3999, 4000-4999, 5000-9999, 10000+.
- revenue_min (number): Lägsta senaste nettoomsättning i kronor.
- revenue_max (number): Högsta senaste nettoomsättning i kronor.
- profit_min (number): Lägsta resultat i kronor.
- profit_max (number): Högsta resultat i kronor.
- equity_ratio_min (number): Lägsta soliditet som decimaltal (0.3 = 30 %).
- revenue_growth_min (number): Lägsta omsättningstillväxt som decimaltal.
- trend (enum): Omsättningstrend.
- f_skatt (boolean): Registrerad för F-skatt.
- vat_registered (boolean): Momsregistrerad.
- employer_registered (boolean): Registrerad arbetsgivare.
- verified (boolean): Verifierat av ägaren.
- registered_from (date): Registrerat från och med datum.
- registered_to (date): Registrerat till och med datum.
- near (string): Mittpunkt som lat,lng för avståndssökning.
- radius_km (number): Radie i km runt near (standard 10, max 500).
- exclude_advertising_blocked (boolean): Utesluter företag med reklamspärr. Obligatoriskt för marknadsföring.
- sort (enum): Sortering. relevance kräver q, distance kräver near.
- limit (integer): Antal per sida, 1–100 (standard 25).
- cursor (string): Värdet från pagination.next_cursor.
- include_total (boolean): Räknar totalt antal (uppskattas om det tar över 1 s).
- fields (string): Kommaseparerade fält att returnera. id ingår alltid.
- expand (enum): Inkludera senaste bokslut eller nyckeltal.