REST API

Alle endpoints kræver en Bearer-token i Authorization-headeren. Generér din token på /profil. Alle responses er JSON.

Autentificering

curl https://cvr.uniteapps.dk/v1/search?q=maersk \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

429 betyder du har brugt din uge-kvote. Se X-RateLimit-Reset-headeren for reset-tidspunkt.

Søgning

GET/v1/search

Fritekst-søgning

Trigram-fuzzy søgning i virksomheder og personer. 8-cifret CVR går direkte til virksomheden uden fuzzy match.

Query / Path parametre

Navn	Type	Default	Beskrivelse
q*	string	—	Søgeord (min. 2 tegn) eller 8-cifret CVR.
type	enum	auto	auto, virksomhed eller person.
page	integer	1	Side-nummer.
limit	integer	25	Max 100.

Eksempel

curl "https://cvr.uniteapps.dk/v1/search?q=maersk" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Eksempel-respons

{
  "data": {
    "results": [
      {
        "type": "virksomhed",
        "id": "32345794",
        "cvr_nummer": 32345794,
        "navn": "A.P. MØLLER - MÆRSK A/S",
        "status": "NORMAL",
        "by": "København K",
        "branche_navn": "Skibsfart",
        "score": 0.95
      }
    ]
  },
  "meta": { "page": 1, "limit": 25, "total": 12, "has_more": false }
}

POST/v1/screen

Bulk-screening og geo-søgning

Struktureret søgning på branche, kommune, virksomhedsform, ansatte, geo-radius. Modes: count_only (kun total), groupBy (aggregeret) eller normal listing.

Request body

Navn	Type	Default	Beskrivelse
branche_kode	string	—	DB07-kode (slå op via /v1/branches).
kommune	string	—	Kommune-navn (delvis match).
geo_lat / geo_lon / geo_radius_meter	number / int	—	Radius-søgning. Alle tre skal angives sammen.
count_only	boolean	false	Returnér kun total.
groupBy	enum	—	branche, kommune, virksomhedsform, stiftelsesaar.
limit	integer	50	Max 500 ved normal listing.

Eksempel

curl -X POST "https://cvr.uniteapps.dk/v1/screen" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"branche_kode":"494100","kommune":"Aarhus","count_only":true}'

GET/v1/random

Tilfældige virksomheder

N tilfældige aktive virksomheder fra dagligt roteret pool. Til crawl-bait eller inspiration.

Query / Path parametre

Navn	Type	Default	Beskrivelse
limit	integer	3	Max 20.

Eksempel

curl "https://cvr.uniteapps.dk/v1/random?limit=5" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Virksomhed

GET/v1/company/{cvr}

Virksomhedsprofil

Stamdata + valgfri sektioner. Default inkluderer alle sektioner.

Query / Path parametre

Navn	Type	Default	Beskrivelse
cvr*	integer	—	8-cifret CVR-nummer.
include	string	—	Komma-separeret: ledelse,ejere,produktionsenheder,noegletal,binavne.
exclude	string	—	Sektioner der skal udelades.

Eksempel

curl "https://cvr.uniteapps.dk/v1/company/32345794?include=ledelse,noegletal" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET/v1/company/{cvr}/financials

Regnskaber og nøgletal

5 års nøgletal med beregnede vækst-procenter. include=raw_xbrl,benchmark,documents for ekstra data.

Query / Path parametre

Navn	Type	Default	Beskrivelse
cvr*	integer	—	8-cifret CVR-nummer.
antal_aar	integer	5	Antal år (max 20).
include	string	—	raw_xbrl, benchmark, documents.

Eksempel

curl "https://cvr.uniteapps.dk/v1/company/32345794/financials?antal_aar=10" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET/v1/company/{cvr}/owners

Ejerstruktur

Ejer-graf op til N niveauer opstrøms (hvem ejer X) og nedstrøms (hvad ejer X).

Query / Path parametre

Navn	Type	Default	Beskrivelse
cvr*	integer	—	8-cifret CVR-nummer.
dybde	integer	3	1-4 niveauer.

Eksempel

curl "https://cvr.uniteapps.dk/v1/company/32345794/owners?dybde=4" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET/v1/company/{cvr}/naerliggende

Top-20 nærmeste virksomheder

Top-20 nærmeste sorteret efter afstand via PostGIS earth_distance. Kræver geocoded virksomhed.

Query / Path parametre

Navn	Type	Default	Beskrivelse
cvr*	integer	—	8-cifret CVR-nummer.

Eksempel

curl "https://cvr.uniteapps.dk/v1/company/32345794/naerliggende" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Person og adresse

GET/v1/person/{enhedsnummer}

Person/deltager-profil

Stamdata + alle aktive roller og ejerskaber for en deltager (person eller virksomhed).

Query / Path parametre

Navn	Type	Default	Beskrivelse
enhedsnummer*	string	—	Deltagerens unikke enhedsnummer.

Eksempel

curl "https://cvr.uniteapps.dk/v1/person/4000584849" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET/v1/companies-at-address

Virksomheder på en konkret adresse

Strict match på postnummer + vejnavn + husnummer. Returnerer både hovedvirksomheder og produktionsenheder.

Query / Path parametre

Navn	Type	Default	Beskrivelse
postnr*	integer	—	Postnummer.
vejnavn*	string	—	Vejnavn (case-insensitive).
husnummer*	string	—	Inkluder evt. bogstav (fx '50A').

Eksempel

curl "https://cvr.uniteapps.dk/v1/companies-at-address?postnr=1263&vejnavn=Esplanaden&husnummer=50" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Reference

GET/v1/branches

DB07 branchekoder

Slå branchekoder op via fritekst eller præfiks. Returnerer matchende koder grupperet efter DB07-division.

Query / Path parametre

Navn	Type	Default	Beskrivelse
soeg	string	—	Søgeord (navn eller kode-præfiks). Tom = top-50.

Eksempel

curl "https://cvr.uniteapps.dk/v1/branches?soeg=transport" \
  -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Vil du teste endpoints live mod prod? Åbn OpenAPI-explorer.