# FirmaAPI

> Dansk CVR API til opslag, søgning og overvågning af virksomheder i Danmark.

## Base URL

`https://firmaapi.dk/api/v1`

## Autentifikation

Send API-nøglen i header:

`X-API-Key: cvr_live_...`

eller

`Authorization: Bearer cvr_live_...`

## Primær integrationsvej

Start med:

`GET /api/v1/company/{cvr}`

Company-endpointet returnerer allerede alle plan-tilgængelige virksomhedsfelter. Brug kun `include=` til de ekstra datablokke, der ikke følger automatisk med.

Anbefalet include:

`GET /api/v1/company/{cvr}?include=history,finance,production_units,relations,events`

## Kerne-endpoints

- `GET /api/v1/company/{cvr}`
- `GET /api/v1/industries`
- `GET /api/v1/municipalities`
- `GET /api/v1/production-unit/{p}`
- `GET /api/v1/company/search?q={query}`
- `GET /api/v1/search/advanced`
- `GET /api/v1/search/net-growth` (netto-vækst pr. tidsbucket)
- `POST /api/v1/company/batch`
- `GET /api/v1/person/{id}` (Professionel+)
- `GET /api/v1/person/search?q={query}` (Professionel+)
- `GET /api/v1/webhooks`
- `POST /api/v1/webhooks`
- `GET /api/v1/webhooks/{id}`
- `PATCH /api/v1/webhooks/{id}`
- `DELETE /api/v1/webhooks/{id}`
- `POST /api/v1/webhooks/{id}/test`
- `GET /api/v1/webhooks/{id}/deliveries`

## Industrikatalog

- Brug `GET /api/v1/industries` til kundesync, når du vil spejle hele branchetræet uden at lave company-opslag først
- Responset indeholder `meta.refreshed_at`, så du kan se hvor frisk snapshotet er
- Snapshotet refreshes periodisk, så branchetællinger vil ofte være omkring et døgn gamle; brug altid `meta.refreshed_at` som den faktiske friskhedsindikator

## Kommunekatalog

- Brug `GET /api/v1/municipalities` til kundesync og referenceopslag, når kunder vil hente de kommunekoder og navne, FirmaAPI eksponerer, én gang og gemme dem lokalt
- Responset er statisk reference-data med `code`, `numeric_code` og `name`
- Kunder kan mappe `numeric_code` til company-feltet `municipality_code` og bruge kataloget som lokal opslagstabel
- Company-payloads indeholder også `municipality_name` som et læsbart convenience-felt

## Datadækning

- Stamdata og kontaktinfo
- Ejere og ledelse
- Regnskabsdata
- Historik
- Produktionsenheder
- Sekundære brancher
- Selskabskapital og tegningsregel
- Formål, binavne, regnskabsklasse, årlig beskæftigelse
- Hændelser: livscyklus, fusioner, spaltninger (Standard+)
- Webhooks for ændringer (inkl. `person.*` events på Professionel+: nye/udtrædende roller, rolleskift, ejerskabsændringer)

## Standard+ (udvidet data)

- `employer_registration_date`, `vat_registration_date`
- `import_registered`, `export_registered`, `excise_registrations`
- `first_fiscal_period_end`, `first_fiscal_period_start`, `history.secondary_names`, `history.quarterly_employment`, `history.monthly_employment`

## Professionel+ (udvidet data)

- Se tabellen ovenfor for de felter, der følger automatisk med på company-endpointet
- `include=relations` tilføjer direkte moder-/datterselskabsrelationer
- Basis+ får `history.register_entries`, `executives` og `board_members`
- `include=history` tilføjer også `emails`, `phones`, `faxes`, `websites` og `registration_numbers` på Professionel+
- `include=production_units` returnerer fulde P-enhedsdetaljer på Professionel+

## Priser (DKK/md)

- Gratis: `0 kr` - `1.000` requests/md, `2 req/s`
- Basis: `79 kr` - `50.000` requests/md, `5 req/s`, ejere, historik, batch (100)
- Standard: `299 kr` - `150.000` requests/md, `10 req/s`, regnskab (1 år) + nøgletal (`ratios`), produktionsenheder, hændelser, webhooks (status + konkurs), batch (200)
- Professionel: `469 kr` - `500.000` requests/md, `20 req/s`, alle features, alle webhook-events, webhook-filtre, batch (500)
- Enterprise: efter aftale - `1.000.000+` requests/md, `50 req/s`, batch (1000), custom SLA

## AI-integration (MCP)

FirmaAPI har en officiel MCP-server til AI-assistenter (Claude, Cursor m.fl.):

```
npm install -g firmaapi-mcp-server    # npm
bun add -g firmaapi-mcp-server        # bun
pnpm add -g firmaapi-mcp-server       # pnpm
```

Konfigurer med `FIRMAAPI_KEY` environment variable. Giver AI'en tools til virksomhedsopslag, søgning, regnskaber og personprofiler.

npm: https://www.npmjs.com/package/firmaapi-mcp-server

## Links

- Dokumentation: https://firmaapi.dk/dokumentation
- OpenAPI spec: https://firmaapi.dk/api/openapi
- Priser: https://firmaapi.dk/priser
- Opret konto: https://firmaapi.dk/register
- Statistik: https://firmaapi.dk/statistik
- Udvidet reference: https://firmaapi.dk/llms-full.txt