API Dokumentation

Integrer danske motorregistreringsdata (DMR) og virksomhedsdata (CVR) i dine applikationer i realtid. Ét API — to kraftfulde datasæt.

Kom i gang

1
Opret en konto

Tilmeld dig gratis og få en API-nøgle med det samme.

2
Hent din API-nøgle

Find din nøgle i betjeningspanelet under API-nøgler.

3
Send forespørgsler

Send forespørgsler med din nøgle i X-API-KEY headeren.

Autentificering

Alle API-forespørgsler kræver en API-nøgle sendt i X-API-KEY headeren.

Header 
X-API-KEY: your_api_key_here

Køretøjs-API

Slå ethvert køretøj registreret i Danmark op via stelnummer (VIN) eller registreringsnummer. Få fulde tekniske specifikationer, synshistorik, udstyr, brændstofdata og mere.

✓ Mærke, model, variant og type
✓ Motordata: cylindre, HK, slagvolumen
✓ Brændstoftype og forbrugsdata
✓ Fuld synshistorik
✓ Udstyrliste
✓ Registreringsstatus og datoer
✓ Miljødata og emissioner
GET /api/v1/vehicles/{ident}

ident — VIN (stelnummer) eller registreringsnummer 

curl -H "X-API-KEY: your_api_key" \
  https://soge.dk/api/v1/vehicles/AB12345

Svareksempel

200 OK application/json 
{
  "data": {
    "vehicle": {
      "koeretoej_ident": "9000012345",
      "stel_nummer": "WVWZZZ3CZWE123456",
      "registrering_nummer": "AB12345",
      "brand": "Volkswagen",
      "model": "Golf",
      "variant": "1.4 TSI Comfortline",
      "type": "Personbil",
      "status": "Registreret",
      "first_registration": "2020-03-15",
      "color": null,
      "total_weight": 1785,
      "curb_weight": 1310,
      "seats": 5,
      "doors": 4,
      "motor": {
        "cylinders": 4,
        "displacement": 1395,
        "max_power_kw": 110,
        "max_power_hp": 150,
        "max_rpm": 5000,
        "mileage": 87432
      },
      "fuel": {
        "type": "Benzin",
        "consumption_mixed": 5.2,
        "consumption_city": 6.8,
        "consumption_highway": 4.3,
        "co2_emission": 120
      },
      "environment": {
        "emission_norm": "Euro 6",
        "particle_filter": true
      }
    },
    "equipment": [
      "ABS", "Airbag", "Klimaanlaeg",
      "Fartpilot", "Parkeringssensor"
    ],
    "syn": [
      {
        "date": "2024-03-10",
        "result": "Godkendt",
        "mileage": 87432
      },
      {
        "date": "2022-03-05",
        "result": "Godkendt",
        "mileage": 54210
      }
    ],
    "permissions": []
  }
}

Virksomheds-API

Søg i danske virksomheder via CVR-nummer eller navn. Få adgang til virksomhedsoplysninger, branchekoder, medarbejderdata, stiftere og mere fra det officielle CVR-register.

✓ Virksomhedsnavn, form og status
✓ CVR-nummer og P-numre
✓ Branchekoder (hoved og bi)
✓ Antal ansatte og intervaller
✓ Stifter- og deltageroplysninger
✓ Adresse og kontaktinformation
✓ Virksomhedens livsforløb og historik
GET /api/v1/companies/{search_term}

search_term — CVR-nummer eller virksomhedsnavn 

curl -H "X-API-KEY: your_api_key" \
  https://soge.dk/api/v1/companies/12345678

Svareksempel

200 OK application/json 
{
  "data": {
    "hits": {
      "total": { "value": 1 },
      "hits": [
        {
          "_source": {
            "Vrvirksomhed": {
              "cvrNummer": 12345678,
              "virksomhedMetadata": {
                "nyesteNavn": {
                  "navn": "Example ApS"
                },
                "nyesteVirksomhedsform": {
                  "langBeskrivelse": "Anpartsselskab"
                },
                "nyesteHovedbranche": {
                  "branchekode": "620100",
                  "branchetekst": "Computerprogrammering"
                },
                "nyesteBeliggenhedsadresse": {
                  "vejnavn": "Vestergade",
                  "husnummerFra": 10,
                  "postnummer": 1456,
                  "postdistrikt": "Copenhagen K"
                }
              },
              "virksomhedsstatus": [
                {
                  "status": "NORMAL"
                }
              ],
              "deltagerRelation": [
                {
                  "deltager": {
                    "navne": [
                      { "navn": "John Doe" }
                    ]
                  }
                }
              ]
            }
          }
        }
      ]
    }
  }
}

Hastighedsgrænser

Free Gratis: 3 anm./min, 1.000 anm./dag
Standard Standard: 120 anm./min, 10.000 anm./dag
Business Business: 600 anm./min, 100.000 anm./dag
Brug for flere forespørgsler? Opgrader din plan

Fejlkoder

200 OK — Anmodning gennemført
401 Uautoriseret — Ugyldig eller manglende API-nøgle
403 Forbudt — API-nøglen er inaktiv
404 Ikke fundet — Køretøj eller virksomhed blev ikke fundet
429 For mange anmodninger — Hastighedsgrænse overskredet

Integrationsscenarier

🚗 Bilforhandler-website Vis fuld køretøjshistorik (DMR, syn, km, forsikring, tilbagekaldelser) på hver annonce via VIN/nummerplade.
🏢 CRM / bogføring Auto-udfyld virksomhedsdata fra CVR — navn, adresse, status, ejere, regnskaber — når du opretter en kunde.
🔍 Modpartstjek Risikovurdér en virksomhed før en aftale: status, ejer-konkurser, ejer- & risikonetværk.
🔔 Overvågning & alerts Følg ændringer på køretøjer eller virksomheder (ejer, status) i din portefølje.

Ofte stillede spørgsmål

Hvordan får jeg en API-nøgle?
Opret en gratis konto, åbn dashboardet og generér en nøgle. Send den som X-API-KEY-header.
Hvad er rate limits?
Trinvist efter plan: Free, Standard og Business — se afsnittet Rate limits ovenfor. Opgradér når som helst.
Hvilke inputformater accepteres?
Køretøjer: 17-tegns VIN eller nummerplade (fx AB12345). Virksomheder: 8-cifret CVR-nummer eller fritekst-navn.
Må jeg bruge det kommercielt?
Ja — på de betalte planer. Data kommer fra officielle danske registre (DMR, CVR).
Hvor friske er dataene?
Køretøjsdata opdateres fra DMR-ETL (ugentligt); virksomhedsdata (CVR) hentes live.
Er der en gratis prøve?
Ja — Free-planen lader dig prøve alle endpoints inden for rate limit, uden kort.

Sundhedstjek

GET /api/v1/health Ingen godkendelse 
{ "status": "healthy", "service": "Soge.dk API", "version": "1.0.0" }