Spring til indholdet
grundviden api

Udviklerguide

Alle kald er GET mod https://pro.grundviden.dk/api/v1/... og svarer JSON.

Til jeres AI-agent

Giv den pro.grundviden.dk/llms.txt - én side med alt, den skal bruge - og OpenAPI-filen.

Planer

To planer, begge pr. virksomhed pr. måned, ekskl. moms. Tinglysning (/land-registry) er kun med i Data + Tingbog; alt andet er med i begge. Et kald til /land-registry med en Data-nøgle svarer 403 plan_does_not_include_route, gratis og uden at tælle; en aktiv Data-kunde kan opgradere.

Se planerne og priserne.

Kom i gang

  1. Vælg plan og tilmeld jer på én side: jeres e-mail, virksomheden (skriv navnet eller CVR-nummeret og vælg på listen), og på Data + Tingbog formålet med opslagene, og vilkårene.
  2. Bekræft e-mailen i den mail, vi sender, og vælg et kodeord - så er kontoen oprettet og tilmeldingen gemt.
  3. Bestil: bekræft planen, prisen og vilkårene. Vi sender en bekræftelse på, at bestillingen er modtaget.
  4. Vi aktiverer jer manuelt, når vi har set virksomheden i CVR og aftalt fakturering, normalt inden for én hverdag.
  5. Opret en nøgle under Nøgler. Den vises kun én gang.
  6. Kald API'et med nøglen i headeren X-Api-Key (aldrig i URL'en). Det er samme kald, som Nøgler viser færdigt med jeres nøgle, på eksempeladressen Strandby Have 22:
curl -H "X-Api-Key: $GV_KEY" \ https://pro.grundviden.dk/api/v1/addresses/strandby-have-22-2670/bbr

Andre adresser finder I ved at skrive dem, som man skriver dem, til adressesøgningen: https://pro.grundviden.dk/api/v1/addresses/resolve?text=strandby%20have%2022. Svaret er adressen; brug den i stedet for eksemplet. Skriv postnummeret med, hvis flere byer har en vej med samme navn.

Adressen

Det I sender

{address} er adressens id (uuid) eller slug. Hvert kald på BBR, skøn og tinglysning gælder én adresse. Boliglisten søger i flere boliger ad gangen.

En bygning med flere enheder

På /estimate og /land-registry svarer en sådan adresse med status: "choose_unit" og en liste units[] (unit_slug, etage, dør, lejlighedsnummer, anvendelseskode, arealer). Svaret har ingen data fra nogen enhed og tæller ikke med i jeres kvote.

En garage, en carport eller en landbrugsbygning ved siden af et hus er ikke en enhed for sig: en gård eller et hus med garage er én ejendom og giver ikke choose_unit.

Det samme gælder et hus med en anden bygning til andet end bolig (for eksempel værksted, butik eller lager) på samme ejendom, når bygningen hverken har en enhedsside eller et BFE-nummer for sig: så er skønnet husets, og noten siger, at de andre bygninger ikke er med.

To huse, eller en bygning med enhedsside eller eget BFE-nummer, er stadig et valg.

Spørg igen med én af enhedernes unit_slug som {address}. Har enheden ingen unit_slug (den har ingen enhedsside hos os), bruger I dens unit_id; units[].id i /bbr er samme id.

Når noget holdes tilbage

Ukendte adresser

En adresse, vi ikke har, besvares med 404 unknown_address, uden at tælle. Det samme gælder en adresse, hvor en enhed ligger i en bygning uden registreret indgang: på alle tre endpoints, aldrig med en kortere liste.

Også adressebeskyttede adresser er med i svarene. En privatperson nævnes kun ved navn i tinglysningssvaret på Data + Tingbog (ejere, debitorer og private långivere, som tinglysningen oplyser dem, højst 24 timer gamle, ingen fødselsdato og ingen adresse); intet andet svar på en adresse nævner en privatperson ved navn.

Et virksomhedssvar nævner de personer, CVR-registret selv offentliggør; også en person med adressebeskyttelse nævnes med navn, som registret giver det (det gør grundviden.dk og det gratis API aldrig).

Servitutternes tekst i tinglysningssvaret står, som registret skriver den, og kan nævne en person; den er ikke begrænset til 24 timer.

Endpoints

StiGiverTællerPlan
/api/v1/addresses/{address}/bbrBygninger, enheder og grund for ejendommen, med BBR's egne felterbbrData og Data + Tingbog
/api/v1/addresses/{address}/estimateForventet pris med nedre og øvre grænseestimateData og Data + Tingbog
/api/v1/searchSøgefeltets svar: adresser, veje, områder, skoler, virksomheder ... (q, evt. u). Hvert adressetræf har sin struktur: kind (access = bygning eller hus, unit = én bolig), dar_id, entrance_dar_id, street, house_number, floor, door, postcode, city, has_units. Hvert boligtræf (unit) navngives som en række i /units: unit_id (BBR-enheden ved døren; null, hvor døren ingen har), unit_slug (enhedssiden; null uden) og slug (nøglen til de andre ruter: enhedssidens slug, ellers BBR-enhedens id); et søgehit og en /units-række forenes på dar_id eller unit_id. limit (1 til 10) begrænser antallet af adressetræfsearchData og Data + Tingbog
/api/v1/addresses/resolveFri tekst til én adresse: text (fx vesterbrogade 10a 1620) giver match exact (200, address), ambiguous (409 ambiguous med candidates og en score fra 0 til 1 for hver) eller none (200). Samme træfform som /api/v1/searchsearchData og Data + Tingbog
/api/v1/companiesVirksomheder og personer i CVR med samme filtre, sorteringer og sider som den åbne søgning (højst 400 sider à 30 med side; hele registret med result.next_cursor sendt tilbage som after, ét opslag pr. side). En personrække (m=person) har person_id og viser personens selskaber, når kaldet peger på én person: enten et navn, der passer på højst 10 personer (kun første side), eller person_id= for netop den person: companies[] med cvr, name, status, ceased, ownership (andel som brøk af 1, hvor registret giver en) og personens egne roles[]; højst 100 selskaber pr. person, companies_total og companies_truncated siger resten. Ellers er companies null, companies_withheld_reason er name_not_specific_enough, og companies_withheld_note siger: gør navnet smallere eller spørg på person_id. Hver virksomhed har advertising_protected: CVR-registerets reklamebeskyttelse (true = virksomheden har frabedt sig at blive brugt til direkte markedsføring, false = nej, null = registret giver ingen værdi). Den binder enhver, der kontakter virksomheder fundet gennem vores datacompaniesData og Data + Tingbog
/api/v1/companies/{cvr}Alt vi ved om ét selskab: registerfelter, regnskab, ejere, ultimative ejere, ledelse, revisorer og vores egne skøn. Med advertising_protected (CVR-registerets reklamebeskyttelse: den binder enhver, der kontakter virksomheder)companiesData og Data + Tingbog
/api/v1/companies/{cvr}/propertiesDe ejendomme et selskab ejer, fra EJF: BFE, adresse, ejerandel og seneste overdragelse (100 pr. side). Direkte (standard), eller med scope=chain også det, selskaberne under det ejer. Med advertising_protected (CVR-registerets reklamebeskyttelse: den binder enhver, der kontakter virksomheder)companiesData og Data + Tingbog
/api/v1/properties/{bfe}/ownership-historyEjerne af én ejendom gennem tiden, fra EJF: hvem, ejerandel, fra hvilken dato til hvilken. Selskaber på begge planer; personer med navn på Data + TingbogcompaniesData og Data + Tingbog
/api/v1/homesBoliglisten: det fulde boligsøg med alle filtre og sorteringer (til salg, til leje, udbud, alle adresser); 30 boliger pr. sidehomesData og Data + Tingbog
/api/v1/addresses/{address}/comparablesDe handler, skønnet bygger på: adresse, måned, pris, m², pris pr. m², afstand (nærmeste først, højst 50)estimateData og Data + Tingbog
/api/v1/addresses/{address}/plan-rulesPlanernes bestemmelser for adressen, ordret (højst 200)bbrData og Data + Tingbog
/api/v1/areas/{area}/buyer-originHvor områdets købere (personer) kom fra, pr. år: kun områdestatistik, aldrig pr. adresse. area er et postnummer (8300) eller en kommunekode (0851). Højst en ny optælling pr. område pr. døgnbbrData og Data + Tingbog
/api/v1/addresses/{address}/unitsAlle enheder under indgangen (en etageejendoms lejligheder, et hus' ene enhed): pr. enhed dar_id, unit_id, unit_slug, slug, etage, dør, boligtype og arealsearchData og Data + Tingbog
/api/v1/addresses/{address}/listing-historyAnnoncehistorikken for adressen eller én lejlighed: hver gang boligen har været annonceret, med mæglerens butiksnavn, annoncens link, første og sidste nat, vi så den, dage på markedet og hver udbudspris (prices). Vores egen historik starter 14. juli 2026 (history_starts)estimateData og Data + Tingbog
/api/v1/addresses/{address}/salesSalgspriser og -datoer for ejendommen, som EJF har dem (Ejerfortegnelsen, ikke Tinglysning): pr. salg overtagelsesdato, aftaledato, pris, overdragelsesform, hvor mange adresser handlen dækker, og om prisen dækker flere ejendomme. Aldrig køber eller sælger. Det er sales-blokken fra /land-registry som egen rute. Samme ejendom igen inden for 24 timer tæller kun én gangestimateData og Data + Tingbog
/api/v1/addresses/{address}/travelRejsen mellem to adresser i ét kald (to er den anden ende): vejafstand og tid i bil (uden trafik), på cykel og til fods, afstand i fugleflugt, begge adressers koordinater og vejafgiften på Storebæltsbroen med varebilens pris, hvis bilruten krydser den. Tager en rute mere end nogle få sekunder, svarer den 202 route_computing, og samme forespørgsel igen svarer straksbbrData og Data + Tingbog
/api/v1/addresses/{address}/land-registryHæftelser og lån, servitutter, kopidato, og købesum fra EJFland_registryKun Data + Tingbog
/api/v1/properties/{bfe}/land-registryDet samme svar som /addresses/{address}/land-registry for en ejendom, der er nævnt med BFE-nummer alene: stien står i land_registry_path på hver række i /companies/{cvr}/properties. Samme plan, samme loft, samme gratis gentagelse inden for 24 timer og samme bestilling; svaret har ingen address-blok og aldrig choose_unitland_registryKun Data + Tingbog
/api/v1/addresses/{address}/land-registry/documents/{document_id}Registrets eget dokument bag en hæftelse, servitut eller adkomst: PDF'en, som registret giver den (ældre dokumenter er scanninger)land_registryKun Data + Tingbog
/api/v1/usageNøglens forbrug denne månedingenData og Data + Tingbog

address

Alle svar har samme address: id, slug, street, number, postcode, city, municipality_code og municipality_name, latitude og longitude (WGS84, 5 decimaler), parcel_number (matrikelnummeret, som adressesiden viser det) og cadastral_district_code (ejerlavskoden). Værdierne er de samme som i det åbne API. Hvad vi ikke har, er null, og address.null_reasons siger hvorfor (engelske sætninger; tomt, når intet mangler). Adressens side er https://grundviden.dk/adresse/{slug}.

/estimate

expected_dkk, low_dkk, high_dkk, comparables (antal sammenlignelige handler) og radius_m. Er tallet tilbageholdt, er felterne null, og note siger hvorfor. En bygning med flere lejligheder har intet skøn som helhed: den svarer choose_unit, og det svar har units_range med laveste og højeste af lejlighedernes egne skøn (se under choose_unit nedenfor). En lejlighed (en enheds slug) får samme skøn som lejlighedens egen side: kind: "dwelling" med tal, interval, antal handler, radius og basis, eller kind: "unavailable" med withheld_reason (shared_bbr_unit, tied_area, multi_home_lot, listed_for_rent, listed_unexplained, no_model_figure) og en note i netop de tilfælde, hvor siden ikke viser et tal. Det er et skøn med et interval, ikke en vurdering.

Annonce er med i adressens svar uden ekstra pris: listing har adressens annonce (status, market, asking_price_dkk, agent som butikkens navn (tom med agent_reason koden agent_unknown, når annoncens navn kan rumme en enkelt mægler), url, area_m2, rooms, first_seen, last_confirmed), vores forskel til udbudsprisen i procent (deviation_pct) eller en kode og en engelsk sætning om, hvorfor vi ikke viser den, og mæglerens egne ord i agent_words, når annoncen siger, at prisen dækker flere boliger. Mæglerens ord er annoncens tekst og gengives kun, hvis hvert ord er kendt. Er der ingen annonce, er listing.exists falsk. Tallene er de samme som i det åbne API, også for adressebeskyttede adresser; ingen enkelt mægler er nævnt, kun butikken. agent er butikkens firmanavn; nogle firmanavne er stifterens navn. En lejlighed (et unit_slug) får den samme listing for sin egen annonce, så man kan sætte udbudsprisen op mod vores skøn for lejligheden.

Det, vi ikke selv står inde for, får I også at se. Viser lejlighedens side ikke et skøn, fordi vi ikke kan forklare det (withheld_reason), men modellen har regnet et tal, ligger det i estimate.unvouched_figure (expected_dkk, low_dkk, high_dkk, comparables, radius_m, vouched: false og reason), ikke i expected_dkk; det er til jeres eget skøn og ikke vores bud. På annoncen er deviation_pct_unfiltered forskellen til udbudsprisen i procent, også hvor deviation_pct er tilbageholdt, og deviation_flag siger hvilket tilfælde det er (over 45 eller 50 procent, annoncen dækker flere boliger, spredte sammenlignelige, eller not_computed: intet af de andre passer, og den gemte afvigelse mangler). deviation_over_45_percent betyder over 45 % i begge retninger (fortegnet står i deviation_pct_unfiltered); deviation_over_50_percent bruges kun for en udbudspris mere end 50 % over vores skøn, det ene tilfælde med sin egen regel (en udbudspris over 1,5 gange skønnet, som siden forklarer med de solgte boliger af samme slags); en pris langt under bliver ved med at være deviation_over_45_percent. Begge felter er også på hver bolig i /homes. agent_advert er annoncens egen tekst om butikken og agent_words_advert annoncens egne ord om flere boliger, som de står (også på hver bolig i /homes); agent og agent_words er som før. I annoncehistorikken viser price_levels alle prisniveauer med quotable; prices er de, vi tør citere.

Offentlig vurdering er med i adressens svar uden ekstra pris: public_valuation har den gældende vurdering (in_force), den endelige (final) og den foreløbige (preliminary), som adressesiden viser dem, hver med year, property_value_dkk og land_value_dkk og covers: whole_property eller residence_part_only. Registret vurderer en landejendoms eller skovejendoms produktionsjord for sig, så den foreløbige vurderings property_value_dkk er kun boligdelen, og jorden står kun i land_value_dkk; preliminary_breakdown har registrets egne dele, covers_note en sætning om det, og whole_property den nyeste vurdering, der dækker hele ejendommen (den endelige, når den gældende er en foreløbig boligdel). land_only siger, at bygningen ikke indgår i tallet, og land_above_property_note forklarer, hvorfor grundværdien kan være højere end ejendomsværdien. Tallene er de samme som i det åbne API; hvad der mangler, er null, og public_valuation.null_reasons siger hvorfor. En lejlighed får samme blok med sin egen endelige og foreløbige vurdering, som lejlighedssiden viser dem.

{ "address": { "id": "bcd4669f-0f02-44db-ae76-2db26c63bdb3", "slug": "strandby-have-22-2670", "street": "Strandby Have", "number": "22", "postcode": 2670, "city": "Greve", "municipality_code": "0253", "municipality_name": "Greve", "latitude": 55.59517, "longitude": 12.33795, "parcel_number": "3dø", "cadastral_district_code": "40652", "null_reasons": {} }, "estimate": { "expected_dkk": 5175000, "low_dkk": 4925000, "high_dkk": 5450000, "comparables": 120, "radius_m": 452, "withheld_reason": null, "note": null }, "listing": { "exists": false, "null_reason": "No active or recent listing is registered for this address." }, "public_valuation": { "in_force": null, "final": null, "preliminary": null, "whole_property": null, "land_only": null, "homes_in_valuation": null, "note": null, "covers_note": null, "preliminary_breakdown": null, "land_above_property_note": null, "land_above_property_source": null, "null_reasons": { "in_force": "We have no public valuation for this property.", "final": "We have no public valuation for this property.", "preliminary": "We have no public valuation for this property.", "whole_property": "We have no public valuation for this property.", "land_only": "We have no public valuation for this property.", "homes_in_valuation": "We have no public valuation for this property.", "note": "We have no public valuation for this property.", "covers_note": "We have no public valuation for this property.", "preliminary_breakdown": "We have no public valuation for this property.", "land_above_property_note": "We have no public valuation for this property.", "land_above_property_source": "We have no public valuation for this property." }, "source": "Vurderingsstyrelsen's public property valuation, our copy, through the address page's own model: the same figures as the free /api/adresse vurdering block (docs https://grundviden.dk/om/kilder)" }, "source": "grundviden.dk model; docs https://grundviden.dk/om/kilder" }

/search, /companies og /companies/{cvr}

Svarene er de åbne ruters egne svar, kørt gennem samme kode, så beskyttede personer maskeres på præcis samme måde som på grundviden.dk (navn og link udelades i ejere, ultimative ejere, ledelse, revision og fuldt ansvarlige deltagere, og registerets fritekst om tegningsregel og formål maskeres). Svaret er pakket ind: items (søgning), result (listen: antal, side, sider, virksomheder) eller record (ét selskab) plus language_note og source. Indholdet af items, result og record har registerets egne danske feltnavne (cvrnr, navn ...) og registerets egne tekster; de sætninger, vi selv skriver (hvorfor et tal mangler, hvorfor ejerlisten er tom), er på engelsk, også i ultimate_owners_reason; konvolutten, fejlene og forbeholdene uden om er på engelsk. Listen er en søgeside, ikke en eksport: højst 400 sider, og en side ud over enden er tom. Kun et svar med status 200 tæller; en ukendt cvr eller en parameter, vi ikke kan læse, er gratis. I opslagsloggen står et selskabs CVR-nummer, og for søgning og liste kun forespørgslens form (parameternavne og værdiernes længde), aldrig den tastede tekst.

{ "record": { "cvrnr": 24256790, "navn": "NOVO NORDISK A/S", "url": "/firma/24256790-novo-nordisk-a-s", "advertising_protected": false, "virksomhedsform": { "kort": "A/S", "lang": "Aktieselskab", "kode": 60 }, "status": { "tekst": "normal", "ophoert": false, "startdato": "1931-11-28T00:00:00", "ophoersdato": null }, "adresse": { "vejnavn": "Novo Alle", "husnr": "1", "postnr": 2880, "kommune": "Gladsaxe", "produktionsenheder": 172 }, "branche": { "kode": "212000", "tekst": "Fremstilling af farmaceutiske præparater", "gruppe": null, "gruppe_navn": null, "bibrancher": [ { "nr": 1, "kode": "201400", "tekst": "Fremstilling af andre organiske basiskemikalier", "aktuel": true }, { "nr": 2, "kode": "211000", "tekst": "Fremstilling af farmaceutiske råvarer", "aktuel": true }, { "nr": 3, "kode": "325000", "tekst": "Fremstilling af medicinske og dentale instrumenter samt udstyr hertil", "aktuel": true } ] }, "kontakt": { "email": null, "telefon": "44448888", "www": null }, "ansatte": { "antal": { "vaerdi": 27151, "forbehold": null }, "aarsvaerk": 26510, "interval": "ANTAL_1000_999999", "aar": 2026, "maaned": 8, "shown": { "value": 27151, "source": "register", "accounts_year": null, "old": false, "months_older_than_accounts": -8 } }, "kapital": { "beloeb": { "vaerdi": 446500000.0, "enhed": "DKK", "forbehold": null }, "tegningsregel": "Selskabet forpligtes ved underskrift (i) af to direktører i forening, (ii) af en direktør eller et bestyrelsesmedlem i forening med bestyrelsens formand eller næstformand eller (iii) af den samlede bestyrelse.", "formaal": "Selskabets formål er at forske i, udvikle, producere og markedsføre farmaceutiske, medicinske og tekniske produkter og ydelser samt anden dertil knyttet virksomhed efter bestyrelsens nærmere bestemmelse. Selskabet tilstræber at drive sin virksomhed på økonomisk, miljømæssigt og socialt ansvarlig vis." }, "regnskab": { "revision_fravalgt": false, "seneste_periode_slut": "2025-12-31T00:00:00", "seneste_periode_start": "2025-01-01T00:00:00", "offentliggjort": "2026-03-27T13:01:18.665Z", "valuta": "DKK", "konsolideret": true, "erklaering": "Auditor's report on audited financial statements", "forbehold": false, "going_concern": null, "resultat": { "vaerdi": 102434000000.0, "enhed": "DKK", "forbehold": null }, "egenkapital": { "vaerdi": 194047000000.0, "enhed": "DKK", "forbehold": null }, "aktiver": { "vaerdi": 542902000000.0, "enhed": "DKK", "forbehold": null }, "omsaetning": { "vaerdi": 309064000000.0, "enhed": "DKK", "forbehold": null }, "revenue_not_stated": false, "xbrl_url": "http://regnskaber.virk.dk/09765242/amNsb3VkczovLzAzL2JjL2I2LzgyLzExL2JmMTktNDlmMy1iNjczLWViM2Y1NmI2ZjViOA.xml", "antal_offentliggjorte": 12 }, "vaerdiestimat": null, "listed": { "exchange": "Nasdaq Copenhagen", "url": "https://www.nasdaq.com/european-market-activity/shares/novo-b" }, "listed_holding": null, "omsaetningsestimat": { "beregnet": true, "n": null, "lav": { "vaerdi": null, "enhed": null, "forbehold": "We do not have this figure for the company." }, "mid": { "vaerdi": null, "enhed": null, "forbehold": "We do not have this figure for the company." }, "hoej": { "vaerdi": null, "enhed": null, "forbehold": "We do not have this figure for the company." } }, "ejere": [ { "navn": "Novo Holdings A/S", "url": "/firma/24257630-novo-holdings-a-s", "er_selskab": true, "cvrnr": 24257630, "andel": { "pct": 0.25, "pct_lav": null, "pct_hoej": null, "noejagtig": true }, "reel_andel_pct": { "pct": null, "pct_lav": 0.25, "pct_hoej": 0.3332, "noejagtig": false }, "stemmeandel_pct": 0.6667, "ophoert": false, "fra": "2000-11-13T00:00:00" } ], "ultimative_ejere": [], "ultimate_owners_reason": { "code": "ends_at_foundation", "text": "The ownership chain ends at a foundation: NOVO NORDISK FONDEN. A foundation has no owners, so there is no ultimate owner to show.", "terminal": [ { "cvrnr": 10582989, "navn": "NOVO NORDISK FONDEN", "form_kort": "EFO", "form": "Erhvervsdrivende fond", "url": "/firma/10582989-novo-nordisk-fonden", "is_foundation": true } ] }, "ledelse": [], "revision": [ { "navn": "DELOITTE STATSAUTORISERET REVISIONSPARTNERSELSKAB", "url": "/firma/33963556-deloitte-statsautoriseret-revisionspartnerselskab", "er_selskab": true, "cvrnr": 33963556, "organ": "Bæredygtighedsrevision", "funktion": "BÆREDYGTIGHEDSREVISION", "fra": "2024-03-21T00:00:00", "til": null, "andel": null, "stemmeandel_pct": null } ], "fuldt_ansvarlige_deltagere": [], "kilde": { "navn": "Det Centrale Virksomhedsregister (CVR)", "side": "/firma/24256790-novo-nordisk-a-s", "bemaerkning": "Register data reproduced as they stand. Fields marked `beregnet` are our own calculations, not the company's own figures." }, "ukendte": [] }, "language_note": "The record is the answer of the free API for the same request: the register's own Danish field names (cvrnr, navn, virksomhedsform ...) and the register's own texts; the sentences we write ourselves (why a figure is missing, why the ownership list is empty, the source note) are English. The envelope, the errors and the withheld reasons around it are English.", "source": "grundviden.dk, from the CVR register (Det Centrale Virksomhedsregister) and our own models; see https://grundviden.dk/om/kilder", "company": { "cvr": 24256790 } }

/companies/{cvr}/properties

De ejendomme, selskabet ejer, fra Ejerfortegnelsen (EJF). scope=direct (standard) er det, selskabet selv ejer: hvad datterselskaber ejer, er ikke med. scope=chain tager også alle selskaber under det i ejerkæden (selskaber, det ejer andele i, og så fremdeles, højst ti led; et ophørt selskab er med og markeres ceased; selskaber, hvis form er en privatpersons, udelades og tælles i excluded_holders; et selskab, hvor intet register kan sige virksomhedsformen, er med og har legal_form null og legal_form_unknown sand): hver ejendom har da held_by (det selskab, der ejer den, og dybden) og held_via (kæden af selskaber fra det spurgte ned til ejeren). holders er antallet af ejende selskaber.

Pr. ejendom: bfe, address_slug (bygningens adresse, til /addresses/{address}; null hvor vi ikke kan placere ejendommen på en adresse), address (en lejligheds egen adresse), unit_slug (en lejligheds sideslug: brug den som {address} for den lejlighed), share, ownership_records og last_transfer_date. share er summen af de brøker, registret oplyser for selskabet på ejendommen: 1 er enejer og under 1 er en medejer; aldrig over 1. ownership_records er antallet af gældende registreringer for selskabet på ejendommen: 1 siden 16.11.2026 (feltet bevares, så kode, der læser det, ikke går i stykker). last_transfer_date er overtagelsesdatoen på ejendommens seneste registrerede overdragelse, ikke datoen, ejerforholdet begyndte.

100 ejendomme pr. side sorteret efter BFE; side er siden, og total, pages og without_address er de rigtige tal. Adressebeskyttede adresser er med, som i opslagene, og ingen person navngives. En enkeltmandsvirksomhed, en personligt ejet mindre virksomhed og et dødsbo ejes af en fysisk person: de svarer med en tom liste og withheld_reason: person_owned_form, fordi API'et ikke viser fysiske personers ejendomme. Et CVR-nummer, hvor intet register kan sige virksomhedsformen, får sine ejendomme listet med legal_form null og legal_form_unknown sand (også på hver rækkes held_by); unknown_legal_form_holders tæller sådanne ejere, og unknown_legal_form_note siger, at vi ikke kan udelukke, at det er en fysisk persons egen virksomhed. Et svar uden ejendomme (også en side efter den sidste) tæller ikke, og ellers tæller hver side som ét opslag sammen med /companies.

{ "company": { "cvr": 42120065, "name": "Ejendomsselskabet Djursland ApS", "legal_form": "APS", "legal_form_name": "Anpartsselskab", "legal_form_unknown": false, "ceased": false, "advertising_protected": true }, "scope": "direct", "scope_note": "Direct holdings only: properties owned by the company's subsidiaries or by other companies it owns shares in are not included.", "total": 25, "without_address": 0, "unknown_legal_form_holders": 0, "unknown_legal_form_note": null, "page": 1, "pages": 1, "page_size": 100, "properties": [ { "bfe": 371867, "land_registry_path": "/api/v1/properties/371867/land-registry", "lookup_key": "oestergade-26-8963-st-tv", "address_slug": "oestergade-26-8963", "address": "Østergade 26", "postal_code": 8963, "postal_town": "Auning", "municipality_code": "0707", "floor": "st", "door": "tv", "unit_slug": "oestergade-26-8963-st-tv", "share": 1.0, "ownership_records": 1, "last_transfer_date": "2023-02-01" }, { "bfe": 371868, "land_registry_path": "/api/v1/properties/371868/land-registry", "lookup_key": "oestergade-28-8963-1-th", "address_slug": "oestergade-26-8963", "address": "Østergade 28", "postal_code": 8963, "postal_town": "Auning", "municipality_code": "0707", "floor": "1", "door": "th", "unit_slug": "oestergade-28-8963-1-th", "share": 1.0, "ownership_records": 1, "last_transfer_date": "2023-02-01" } ], "withheld_reason": null, "note": null, "source": "grundviden.dk, from the EJF ownership register (Ejerfortegnelsen) through the Danish Agency for Data Supply and Infrastructure, current company-held ownership; the address is the one we resolve the property to" }

/properties/{bfe}/ownership-history

Ejerne af én ejendom gennem tiden, fra Ejerfortegnelsen (EJF), for en ejendom udpeget ved sit BFE-nummer (bfe på en række i /companies/{cvr}/properties). ownership_history er sorteret med den ældste først, én række pr. ejer og periode: owner (kind er company eller person; et selskab har cvr, name, legal_form, legal_form_unknown og ceased, en person kun name og name_status), share (den faktiske andel som brøk af 1) og registered_share (andelen i tingbogen: en køber er tinglyst ejer fra skødet, men faktisk ejer først fra overtagelsesdagen, så de to kan afvige i en periode), owned_from og owned_to (en dato, null hvor registret ingen angiver), current (sand, mens ejerskabet består) og owned_before_1998 (registrets eget mærke: datoer før 1. juli 1998 er upræcise).

Data + Tingbog får også de ejere, der er fysiske personer: med navn, som registret skriver det, og med ejerandel og datoer. Ingen adresse, ingen fødselsdato, intet CPR-nummer. name_status siger, hvorfor et navn er der eller ikke er der: given, withheld_by_register (registret giver intet navn) eller withheld_protected (en adressebeskyttet person, når navnene til betalende kunder er slået fra; i dag er de slået til, så en adressebeskyttet person nævnes som alle andre, det gør grundviden.dk og det gratis API aldrig). Vilkårenes regler gælder også her: I må aldrig henvende jer til en person, og navnene er til jeres egen interne brug. På Data vises ejere, der er personer, ikke: withheld_periods tæller deres perioder, og persons_note siger det.

Enkeltmandsvirksomheder, personligt ejede mindre virksomheder og dødsboer (ENK, PMV, DØD) vises på Data + Tingbog som personer: kind: "person", med det navn, registret har for virksomheden, og uden CVR-nummer. Det gælder, så længe navnene til betalende kunder er slået til (i dag er de det); er de slået fra, tælles de i withheld_periods. På Data tælles de altid. Ejere, som registret hverken navngiver som person eller selskab, tælles også i withheld_periods. source er kreditlinjen («Indeholder data fra Geodatastyrelsen, Ejerfortegnelsen» og datoen for vores kopi), source_terms er vilkårene, og source_note siger, at Geodatastyrelsen ikke godkender eller anbefaler tjenesten. Højst 1.000 perioder (truncated). Tæller som ét opslag sammen med /companies, for hvert kald (24-timers-reglen, hvor samme ejendom læst igen tæller én gang, gælder tingbogs-, BBR-, skøn- og annoncehistorik-ruterne, ikke denne); et svar uden en vist periode er gratis. Eksemplet nedenfor er et selskabssvar fra en rigtig ejendom; derefter et Data + Tingbog-svar med en person, opfundet.

{ "property": { "bfe": 100553324, "land_registry_path": "/api/v1/properties/100553324/land-registry" }, "ownership_history": [ { "owner": { "kind": "company", "cvr": 32277802, "name": "LIND & RISØR A/S", "legal_form": "A/S", "legal_form_name": "Aktieselskab", "legal_form_unknown": false, "ceased": false }, "share": 1.0, "registered_share": 1.0, "owned_from": "2022-10-12", "owned_to": "2024-11-03", "current": false, "owned_before_1998": false }, { "owner": { "kind": "company", "cvr": 32277802, "name": "LIND & RISØR A/S", "legal_form": "A/S", "legal_form_name": "Aktieselskab", "legal_form_unknown": false, "ceased": false }, "share": 1.0, "registered_share": 0.0, "owned_from": "2024-11-03", "owned_to": "2025-01-21", "current": false, "owned_before_1998": false }, { "owner": { "kind": "company", "cvr": 44619466, "name": "Strandby Have ApS", "legal_form": "APS", "legal_form_name": "Anpartsselskab", "legal_form_unknown": false, "ceased": false }, "share": 0.0, "registered_share": 1.0, "owned_from": "2024-11-03", "owned_to": "2025-01-21", "current": false, "owned_before_1998": false }, { "owner": { "kind": "company", "cvr": 44619466, "name": "Strandby Have ApS", "legal_form": "APS", "legal_form_name": "Anpartsselskab", "legal_form_unknown": false, "ceased": false }, "share": 1.0, "registered_share": 1.0, "owned_from": "2025-01-21", "owned_to": null, "current": true, "owned_before_1998": false } ], "total": 4, "truncated": false, "withheld_periods": 0, "persons_note": null, "unknown_legal_form_owners": 0, "unknown_legal_form_note": null, "note": null, "source": "Indeholder data fra Geodatastyrelsen, Ejerfortegnelsen, 2026-11-17", "source_terms": "https://datafordeler.dk/vejledning/brugervilkaar/ejerfortegnelsen-ejf/", "source_note": "Geodatastyrelsen does not approve, support or recommend grundviden.dk or this service. The data is our copy of the Ejerfortegnelsen, updated daily." }
{ "property": { "bfe": 100000000, "land_registry_path": "/api/v1/properties/100000000/land-registry" }, "ownership_history": [ { "owner": { "kind": "person", "name": "Fornavn Efternavn", "name_status": "given" }, "share": 1.0, "registered_share": 1.0, "owned_from": "2009-06-01", "owned_to": "2021-03-15", "current": false, "owned_before_1998": false }, { "owner": { "kind": "company", "cvr": 44619466, "name": "Strandby Have ApS", "legal_form": "APS", "legal_form_name": "Anpartsselskab", "legal_form_unknown": false, "ceased": false }, "share": 1.0, "registered_share": 1.0, "owned_from": "2021-03-15", "owned_to": null, "current": true, "owned_before_1998": false } ], "total": 2, "truncated": false, "withheld_periods": 0, "persons_note": null, "unknown_legal_form_owners": 0, "unknown_legal_form_note": null, "note": null, "source": "Indeholder data fra Geodatastyrelsen, Ejerfortegnelsen, 2026-11-17", "source_terms": "https://datafordeler.dk/vejledning/brugervilkaar/ejerfortegnelsen-ejf/", "source_note": "Geodatastyrelsen does not approve, support or recommend grundviden.dk or this service. The data is our copy of the Ejerfortegnelsen, updated daily." }

/homes

Boliglisten er det fulde boligsøg fra grundviden.dk, med alle filtre og sorteringer (111 parametre, hver beskrevet i OpenAPI-filen) og fire markeder: m=salg (standard), leje, udbud (boliger solgt ved udbud eller auktion) og adr (alle adresser med vores skønspris og uden annonce, flere millioner rækker: indsnævr med et filter). Adressebeskyttede adresser er med, som i opslagene, og ingen person er nævnt. En række i homes[] er søgekortets egen post under engelske feltnavne (price_dkk, area_m2, rooms, built_year, energy_label, deviation_pct ...; alle felter står under ordliste nedenfor og i hjemmeskemaet i OpenAPI-filen); de sætninger og mærker, vi selv skriver på kortet (estimate_note, oil_tank_note, oil_tank_level, sold_mark, open_house), er på engelsk, mens det, der er registerets eller mæglerens egne ord (dwelling_type, sale_form, condition_words, text_themes), står, som de er; konvolutten, fejlene, noterne og parameterbeskrivelserne i OpenAPI-filen er på engelsk.

De ti filtre, I oftest bruger. Flere værdier skrives med komma. Resten står i OpenAPI-filen.

ParameterVærdierBetyder
msalg (standard), leje, udbud, adrMarkedet
omrpostnr:2000 (eller blot 2000), kommune:<slug>, by:<navn>, bydel:<slug>, landsdel:<slug>, bbox:<vest,syd,øst,nord>Området
typehus, raekkehus, lejlighed, fritid (sommerhus), andel, landejendom, grund, almenBoligkategorien
prismaxkroner (og prismin)Højeste udbudspris; på m=adr højeste skønspris
afvmaxheltal i procent, med fortegn (og afvmin)Udbudsprisen mod vores skøn, inklusive: afvmax=-1 giver boliger udbudt mindst 1 % under skønnet. Kun m=salg. Se «Skøn og afvigelse» nedenfor
arealminm² (og arealmax)Mindste boligareal
vaerminantal (og vaermax)Færrest værelser
energifraA til G (og energitil)Bedste energimærke, der accepteres
nedsat1Kun boliger, hvor udbudsprisen er sat ned, siden vi første gang så dem
sortny (standard), prisop, prisned, kvm, liggetid, afv (mest under vores skøn), aabent, renoSorteringen; gyldige værdier afhænger af markedet
side1, 2, 3 ...Siden (30 boliger)
{ "total": 30, "page": 1, "pages": 1, "page_size": 30, "homes": [ { "id": 12284335, "address_slug": "herningvej-165-9220", "unit_slug": null, "address": "Herningvej 165, 9220 Aalborg Øst", "status": "for_sale", "dwelling_type": "Villalejlighed", "villa_flat": 1, "price_dkk": 1295000, "price_per_m2_dkk": 13350, "price_withheld": null, "price_change_pct": null, "days_on_market": 5, "area_m2": 97, "rooms": 2, "plot_m2": 13499, "built_year": 1984, "energy_label": "B", "deviation_pct": null, "outside_estimate_range": false, "estimate_note": null, "agent": "EDC Danebo", "url": "https://www.edc.dk/alle-boliger/andelsbolig/9220-aalborg-oest/herningvej-165/91005823", "sale_form": null, "bid_deadline": null, "open_house": "16.11. at 11.00-18.00", "sold_mark": null, "last_confirmed_note": null, "balcony": null, "lift": null, "pets_allowed": null, "deposit_dkk": null, "prepaid_rent_dkk": null, "aconto_dkk": null, "available_from": null, "available_now": null, "dwellings_on_property": 24, "sea_view": null, "lake_view": null, "noise_band": null, "livestock_nearby": null, "preservation": null, "soil_contamination_v1": null, "soil_contamination_v2": null, "vulnerable_area": null, "oil_tank_grade": null, "oil_tank_note": null, "oil_tank_level": null, "renovated_value_dkk": null, "as_is_value_dkk": null, "renovation_building_weight": null, "sales_text_condition": null, "text_themes": null, "condition_words": null, "agent_advert": "EDC Danebo", "agent_words_advert": null, "deviation_pct_unfiltered": null, "deviation_flag": null }, { "id": 11061090, "address_slug": "marshalls-alle-2-9220", "unit_slug": "marshalls-alle-2-9220-3-6", "address": "Marshalls Alle 2, 9220 Aalborg Øst", "status": "for_sale", "dwelling_type": "Ejerlejlighed", "villa_flat": 0, "price_dkk": 1295000, "price_per_m2_dkk": 27553, "price_withheld": null, "price_change_pct": null, "days_on_market": 10, "area_m2": 47, "rooms": 2, "plot_m2": 393, "built_year": 2018, "energy_label": "A", "deviation_pct": 4, "outside_estimate_range": false, "estimate_note": null, "agent": "home Ejerlejlighedsbutikken Aalborg", "url": "https://home.dk/salg/lejligheder/marshalls-alle-2-36-9220-aalborg-oest/sag-8090001695/", "sale_form": null, "bid_deadline": null, "open_house": "22.11. at 12.00-16.00", "sold_mark": null, "last_confirmed_note": null, "balcony": true, "lift": true, "pets_allowed": null, "deposit_dkk": null, "prepaid_rent_dkk": null, "aconto_dkk": null, "available_from": null, "available_now": null, "dwellings_on_property": 28, "sea_view": null, "lake_view": null, "noise_band": null, "livestock_nearby": null, "preservation": null, "soil_contamination_v1": null, "soil_contamination_v2": null, "vulnerable_area": null, "oil_tank_grade": null, "oil_tank_note": null, "oil_tank_level": null, "renovated_value_dkk": null, "as_is_value_dkk": null, "renovation_building_weight": null, "sales_text_condition": 0, "text_themes": null, "condition_words": "indflytningsklar", "agent_advert": "home Ejerlejlighedsbutikken Aalborg", "agent_words_advert": null, "deviation_pct_unfiltered": 4, "deviation_flag": null } ], "unknown_parameters": [], "interpreted": {}, "next_cursor": null, "language_note": "A home is the free search card's own record under English field names (see the home schema in openapi.json). The sentences and labels we write ourselves (estimate_note, oil_tank_note, oil_tank_level, sold_mark, open_house) are English; the few values that are the register's or the agent's own words (dwelling_type, sale_form, condition_words) stay as they are; the envelope, the errors and the notes are English.", "source": "grundviden.dk, from the agents' own adverts (our crawl), BBR and our own models; see https://grundviden.dk/om/kilder" }

/comparables

De handler, skønnet for netop denne adresse eller enhed bygger på, så I kan efterprøve tallet. Kun handler, som skønnet faktisk bruger (samme udvalg og filtre som siden: kun frie handler, og kun handler af én ejendom ad gangen); viser siden intet tal, får I samme withheld_reason som på /estimate og ingen handler. For en bolig er det rækkerne i sidens egen tabel «Handlerne vi sammenligner med»; for en erhvervsenhed er det de handler, båndet er regnet over, med total_trades_behind_estimate (det, tallet bygger på, fx 221), listed_trades_available (det, vi kan vise, før loftet på 50) og vinduet (selection.window). Hver handel har address, date (måned, ÅÅÅÅ-MM), price_dkk, area_m2, price_per_m2_dkk, distance_m, same_building, same_street, same_unit_traded_again og url til handlens egen offentlige side; højst 50, nærmeste først. subject_own_trades er ejendommens egne salg (EJF) med forskellen til skønnets median pr. m²; de er ikke en del af båndet, medmindre counted_in_estimate er sand. Alle felter er fra EJF (ikke Tinglysning). Handler på adressebeskyttede adresser er med, som i opslagene, og ingen person navngives. Tæller som ét skønsopslag; samme adresse igen inden for 24 timer på samme kilde er gratis, så /comparables efter /estimate på én adresse koster ikke ekstra.

{ "address": { "id": "bcd4669f-0f02-44db-ae76-2db26c63bdb3", "slug": "strandby-have-22-2670", "street": "Strandby Have", "number": "22", "postcode": 2670, "city": "Greve", "municipality_code": "0253", "municipality_name": "Greve", "latitude": 55.59517, "longitude": 12.33795, "parcel_number": "3dø", "cadastral_district_code": "40652", "null_reasons": {} }, "unit": null, "kind": "dwelling_model", "withheld_reason": null, "note": null, "list_caveat": null, "total_trades_behind_estimate": 120, "listed_trades_available": 120, "listed": 50, "max_listed": 50, "truncated": true, "date_precision": "month", "date_basis": "the month the public comparables block prints for the trade (the agreement month where the register has a usable agreement date, else the takeover month)", "selection": { "rule": "Free trades of the same home type from the last 3 years. Each trade's price per m2 is lifted to today's price level and adjusted for differences in size, plot, year built, energy label, noise and neighbourhood; our estimate starts from the median of them.", "median_per_m2_dkk": 38244 }, "comparables": [ { "kind": "dwelling_model", "url": "https://grundviden.dk/adresse/strandby-have-22-2670", "unit_slug": null, "address": { "street": "Strandby Have", "number": "22", "floor": null, "door": null, "postcode": 2670, "city": "Greve" }, "date": "2024-02", "price_dkk": 4375000, "area_m2": 132, "price_per_m2_dkk": 33143, "adjusted_price_per_m2_dkk": 39523, "distance_m": 0, "same_building": true, "same_street": true, "same_unit_traded_again": false, "is_subject_own_trade": true, "price_covers_several_properties": false, "area_covers_homes": null }, { "kind": "dwelling_model", "url": "https://grundviden.dk/adresse/strandby-have-24-2670", "unit_slug": null, "address": { "street": "Strandby Have", "number": "24", "floor": null, "door": null, "postcode": 2670, "city": "Greve" }, "date": "2024-02", "price_dkk": 4375000, "area_m2": 132, "price_per_m2_dkk": 33143, "adjusted_price_per_m2_dkk": 39581, "distance_m": 6, "same_building": false, "same_street": true, "same_unit_traded_again": false, "is_subject_own_trade": false, "price_covers_several_properties": false, "area_covers_homes": null }, { "kind": "dwelling_model", "url": "https://grundviden.dk/adresse/strandby-have-20-2670", "unit_slug": null, "address": { "street": "Strandby Have", "number": "20", "floor": null, "door": null, "postcode": 2670, "city": "Greve" }, "date": "2024-02", "price_dkk": 4187500, "area_m2": 132, "price_per_m2_dkk": 31723, "adjusted_price_per_m2_dkk": 37786, "distance_m": 6, "same_building": false, "same_street": true, "same_unit_traded_again": false, "is_subject_own_trade": false, "price_covers_several_properties": false, "area_covers_homes": null } ], "subject_own_trades": { "note": "The subject property's own registered sales (EJF). A sale is part of the estimate only where counted_in_estimate is true; the window below is why an older sale is not.", "window": { "rule": "Free trades of the same home type from the last 3 years. Each trade's price per m2 is lifted to today's price level and adjusted for differences in size, plot, year built, energy label, noise and neighbourhood; our estimate starts from the median of them." }, "subject_area_m2": 132, "subject_registered_area_m2": null, "estimate_median_per_m2_dkk": 38244, "items": [ { "date": "2024-02-26", "takeover": "2025-01-22", "agreement": "2024-02-26", "price_dkk": 4375000, "area_m2": 132, "price_per_m2_dkk": 33143, "price_per_m2_on_registered_area_dkk": null, "vs_median_per_m2_dkk": -5101, "transfer_type": "Almindelig fri handel", "free_trade": true, "price_covers_several_properties": false, "counted_in_estimate": true } ] }, "source": "EJF (Ejerfortegnelsen) via our sold-homes tables; not Tinglysning. `url` is the address of the traded home's page on grundviden.dk; the page of an address-protected home is not public." }

/plan-rules

De bestemmelser i de planer, der gælder for adressen, ordret med planens egne danske ord, grupperet pr. plan (nummer, navn, link til dokumentet, år). Hver bestemmelse har paragraf, overskrift, emner, status (in_force, maybe_repealed, repealed) og sidetal. Nyeste og gældende først, højst 200; truncated viser, at grænsen slog til. Tæller som ét bbr-opslag; /plan-rules efter /bbr på samme adresse inden for 24 timer er gratis. En plan hører til grunden: en bygningsadresse svarer uden valg af enhed. Teksten er planernes egne ord og kan nævne embedsmænd, der har underskrevet dem, og dem, et sted er opkaldt efter. Adressebeskyttede adresser er med, som i opslagene.

{ "address": { "id": "0a3f507a-f758-32b8-e044-0003ba298018", "slug": "slusevej-99-2300", "street": "Slusevej", "number": "99", "postcode": 2300, "city": "København S", "municipality_code": "0101", "municipality_name": "København", "latitude": 55.62894, "longitude": 12.58573, "parcel_number": "25b", "cadastral_district_code": "2000170", "null_reasons": {} }, "unit": null, "language": "da", "provisions_total": 30, "provisions_listed": 30, "max_listed": 200, "truncated": false, "plans": [ { "plan_number": "408", "plan_name": "Hf. Våren", "document_url": "https://dokument.plandata.dk/20_1072787_APPROVED_1297679120599.pdf", "adopted": "2007-02-08", "adopted_year": "2007", "provisions": [ { "paragraph": "§ 1", "section": "1", "heading": null, "kind": "rule", "status": "in_force", "topics": [ "omfang_hoejde", "anvendelse", "udstykning" ], "text": "§ 1. Formål Lokalplanen udgør det planmæssige grundlag for anvendelse af haveforeningen Våren, der oprindeligt er et kolonihaveområde, til helårsboliger. Som led heri skal følgende overordnede hensyn tilgodeses: - Området fastlægges til helårsboliger i form af énfamiliehuse. - Den oprindelige opdeling i lodder, der varierer fra 480 til 840 m2 med en gennemsnitlig størrelse på ca. 625 m², fastholdes i princippet, og det muliggøres, at der kan ske en matrikulær udstykning svarende hertil med vejadgang via de eksisterende interne adgangsstier. - Med bestemmelser om byggelinier og grønne forhaver tilstræbes, at området fortsat fremtræder med et grønt præg samtidig med, at der på hver parcel tillades et hus på mellem 120 og 150 m2, under iagttagelse af bestemmelser, der skal forhindre brandsmitte mellem husene. - Utidssvarende servitutter skal ophæves. - Ved såvel bygningsrenovering og nybyggeri som anlæg af friarealer skal det i videst muligt omfang sikres, at det sker efter miljørigtige og bæredygtige principper.", "page": 10, "ocr_confidence": null }, { "paragraph": "§ 2", "section": "2", "heading": null, "kind": "rule", "status": "in_force", "topics": [ "udstykning" ], "text": "§ 2. Lokalplanområdet Lokalplanområdet er afgrænset som vist på tegning nr. 1 og omfatter ejendommen matr.nr. 26 samt dele af ejendommene matr. nr. 25a og 25b Sundby Overdrev, København, og alle parceller, der udstykkes fra ejendommene efter den 1. april 2006.", "page": 10, "ocr_confidence": null } ] } ], "note": "The provisions are quoted from the local plans, framework plans and sub-area plans that apply to the address, in the plans' own Danish, which can name officials who signed them and the people a place is named after. A plan marked maybe_repealed could not be placed against a repeal; check the plan document at document_url. Not an authority's decision.", "source": "grundviden.dk, from the plan documents in the Plandata register (the plan's own link in document_url)" }

/buyer-origin

Hvor personer, der købte ejendomme i et område, boede før, pr. år: kun områdestatistik, aldrig pr. adresse. Stien tager et fircifret postnummer (8300) eller en kommunekode (0851). Pr. år står buyers (personer, der står som købere på de skøder, vi har for området, og hvis tidligere bopæl vi kender) og andelen i procent, der boede i samme kommune (same_municipality_pct), andetsteds i samme region (elsewhere_in_region_pct) eller i en anden region (other_region_pct); regionerne er de fem officielle, med Bornholm i Hovedstaden. Året er overtagelsesåret.

Mindst 10 købere pr. tal. Et år med færre end 10 købere vises ikke: det står som withheld: true med reason og uden antal. Der er med vilje ingen samlet sum over alle år, så et skjult år ikke kan regnes ud. Tallene gælder de skøder, vi har for området: en del af områdets handler, ikke alle, så små områder viser ofte ingen år. En køber er en person, der står som ny ejer på et skøde (for det meste salg; også nogle få skifteretsattester, bodelinger og auktionsskøder), og tælles én gang, uanset hvor mange af områdets ejendomme personen får på det skøde; to personer på samme skøde er to købere. Virksomheder tælles ikke: vi læser ingen adresse for en virksomhed. En køber, hvis opgivne adresse er den købte ejendom selv, tælles ikke. Svaret har ingen adresser, ejendomme, skøder eller navne.

Tæller som ét bbr-opslag pr. område pr. døgn; et svar uden noget år vist er gratis og tælles ikke. Et område, vi ikke kender, giver 404 unknown_area, en ugyldig værdi 400 invalid_area; begge er gratis.

{ "area": { "type": "municipality", "code": "0851", "name": "Aalborg" }, "minimum_buyers": 10, "years": [ { "year": 2027, "withheld": true, "reason": "fewer_than_minimum_buyers", "minimum_buyers": 10 }, { "year": 2026, "withheld": false, "buyers": 141, "same_municipality_pct": 91.5, "elsewhere_in_region_pct": 5.0, "other_region_pct": 3.5 }, { "year": 2025, "withheld": false, "buyers": 219, "same_municipality_pct": 89.0, "elsewhere_in_region_pct": 7.8, "other_region_pct": 3.2 }, { "year": 2024, "withheld": false, "buyers": 66, "same_municipality_pct": 84.8, "elsewhere_in_region_pct": 6.1, "other_region_pct": 9.1 }, { "year": 2023, "withheld": true, "reason": "fewer_than_minimum_buyers", "minimum_buyers": 10 }, { "year": 2022, "withheld": true, "reason": "fewer_than_minimum_buyers", "minimum_buyers": 10 } ], "basis": "People named as buyers on the deeds of properties in the area whose earlier home is known, by the year they took over. Share of those buyers who lived before in the same municipality, elsewhere in the same region, or in another region (the five official regions, Bornholm in Hovedstaden).", "note": "Area statistics only, never per address. A year is shown only with at least 10 buyers; a year below that is withheld and carries no count. Counted are the buyers on the deeds we hold for the area, a part of its sales and not all of them. A buyer whose stated address is the property bought, or whose earlier address we cannot place in a municipality, is not counted. A buyer is a person named as a new owner on a deed we hold (mostly sales; a few estate divisions, auctions and probate certificates), counted once however many properties of the area that person got on that deed; two persons on one deed are two buyers. Companies are not counted: we read no address for a company.", "source": "grundviden.dk, from the deeds of the Danish land registry (Tinglysning) and the address register" }

/units

Alle enheder under adressens indgang, så en forslagsboks kan spørge «hvilken lejlighed?», når bygningen er valgt. Samme enheder som søgningen viser for en indgang (DAR's døradresser, plus de BBR-enheder, ingen døradresse nævner), så hvert dar_id i et søgehit står her. Pr. enhed: dar_id (DAR's adresse-id for døren; én række pr. dør), unit_id (BBR-enhedens id; null, hvor døren ingen BBR-enhed har), unit_slug (enhedssidens slug; null, hvor enheden ingen side har), slug (nøglen, I giver videre som {address}: enhedssidens slug, ellers BBR-enhedens id), floor og door (DAR's egne for døren, ellers enhedssidens, ellers BBR's), dwelling_type, area_bbr_m2, area_registered_m2 og rooms. Rækkefølge: st, 1, 2 ...; højst 500 (truncated). Har adressen ingen enhed af sig selv (ingen bygning med enheder på husnummeret, fx en etageejendom registreret på andre numre), står ejendommens enheder her i stedet: bygningerne på samme matrikel, som /bbr viser dem, hver med sit eget dar_id; /estimate og /land-registry svarer choose_unit for dem, når der er to eller flere. units_found er det, vi fandt, ikke et registertal; found_capped er sand, når vores opslag nåede deres lofter. {address} er et adresse-id eller en slug, eller en enheds slug eller id (så får I enhedens indgang). Tæller som ét opslag af kilden search pr. kald (ikke én gang pr. ejendom), uden for lofterne for bbr, estimate og tinglysning; en ukendt adresse er et gratis 404.

{ "address": { "id": "0a3f5081-e8cd-32b8-e044-0003ba298018", "slug": "frederiksborgvej-38d-4000", "street": "Frederiksborgvej", "number": "38D", "postcode": 4000, "city": "Roskilde", "municipality_code": "0265", "municipality_name": "Roskilde", "latitude": 55.64676, "longitude": 12.08383, "parcel_number": "775a", "cadastral_district_code": "2000351", "null_reasons": {} }, "entrance_dar_id": "0a3f5081-e8cd-32b8-e044-0003ba298018", "units_found": 12, "found_capped": false, "units_listed": 12, "truncated": false, "units": [ { "dar_id": "0a3f50ab-d698-32b8-e044-0003ba298018", "unit_id": "e5cd7dee-0dec-429b-9089-6cfab0488cd1", "unit_slug": "frederiksborgvej-38d-4000-st-1", "slug": "frederiksborgvej-38d-4000-st-1", "floor": "st", "door": "1", "apartment_number": 37, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 52, "area_registered_m2": 48, "rooms": 1 }, { "dar_id": "0a3f50ab-d699-32b8-e044-0003ba298018", "unit_id": "d042d0ed-0865-41f9-bb64-1c29d1362522", "unit_slug": "frederiksborgvej-38d-4000-st-2", "slug": "frederiksborgvej-38d-4000-st-2", "floor": "st", "door": "2", "apartment_number": 38, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 52, "area_registered_m2": 48, "rooms": 1 }, { "dar_id": "0a3f50ab-d69a-32b8-e044-0003ba298018", "unit_id": "0b862318-e3fb-455a-8df5-27cc46eaad85", "unit_slug": "frederiksborgvej-38d-4000-st-3", "slug": "frederiksborgvej-38d-4000-st-3", "floor": "st", "door": "3", "apartment_number": 39, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 51, "area_registered_m2": 46, "rooms": 1 }, { "dar_id": "0a3f50ab-d69b-32b8-e044-0003ba298018", "unit_id": "6e324daa-8e16-4162-a248-ea6078fe85af", "unit_slug": "frederiksborgvej-38d-4000-st-4", "slug": "frederiksborgvej-38d-4000-st-4", "floor": "st", "door": "4", "apartment_number": 40, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 51, "area_registered_m2": 46, "rooms": 2 }, { "dar_id": "0a3f50ab-d69c-32b8-e044-0003ba298018", "unit_id": "cacbcfac-5a85-4674-8fce-884cc2eacf1d", "unit_slug": "frederiksborgvej-38d-4000-1-1", "slug": "frederiksborgvej-38d-4000-1-1", "floor": "1", "door": "1", "apartment_number": 41, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 52, "area_registered_m2": 48, "rooms": 1 }, { "dar_id": "0a3f50ab-d69d-32b8-e044-0003ba298018", "unit_id": "6a82e952-bbcf-4c73-a35a-6fc731b511c5", "unit_slug": "frederiksborgvej-38d-4000-1-2", "slug": "frederiksborgvej-38d-4000-1-2", "floor": "1", "door": "2", "apartment_number": 42, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 52, "area_registered_m2": 48, "rooms": 1 }, { "dar_id": "0a3f50ab-d69e-32b8-e044-0003ba298018", "unit_id": "acfe90c6-c1c1-4f51-abda-163802d2354e", "unit_slug": "frederiksborgvej-38d-4000-1-3", "slug": "frederiksborgvej-38d-4000-1-3", "floor": "1", "door": "3", "apartment_number": 43, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 51, "area_registered_m2": 46, "rooms": 1 }, { "dar_id": "0a3f50ab-d69f-32b8-e044-0003ba298018", "unit_id": "2a04dccc-ee87-49fb-8eb1-035af5c97c0f", "unit_slug": "frederiksborgvej-38d-4000-1-4", "slug": "frederiksborgvej-38d-4000-1-4", "floor": "1", "door": "4", "apartment_number": 44, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 51, "area_registered_m2": 46, "rooms": 2 }, { "dar_id": "0a3f50ab-d6a0-32b8-e044-0003ba298018", "unit_id": "7b66c1c3-94d7-435a-95a5-8b6f9180c713", "unit_slug": "frederiksborgvej-38d-4000-2-1", "slug": "frederiksborgvej-38d-4000-2-1", "floor": "2", "door": "1", "apartment_number": 45, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 52, "area_registered_m2": 48, "rooms": 1 }, { "dar_id": "0a3f50ab-d6a1-32b8-e044-0003ba298018", "unit_id": "77d6bb29-4805-44bf-b1a4-03ac8e2dd443", "unit_slug": "frederiksborgvej-38d-4000-2-2", "slug": "frederiksborgvej-38d-4000-2-2", "floor": "2", "door": "2", "apartment_number": 46, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 52, "area_registered_m2": 48, "rooms": 1 }, { "dar_id": "0a3f50ab-d6a2-32b8-e044-0003ba298018", "unit_id": "4a365931-4005-4849-bf3f-b2e1bf5b4f5d", "unit_slug": "frederiksborgvej-38d-4000-2-3", "slug": "frederiksborgvej-38d-4000-2-3", "floor": "2", "door": "3", "apartment_number": 47, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 51, "area_registered_m2": 46, "rooms": 1 }, { "dar_id": "0a3f50ab-d6a3-32b8-e044-0003ba298018", "unit_id": "9c1ab097-42a8-4994-bf0d-cd1fe679e074", "unit_slug": "frederiksborgvej-38d-4000-2-4", "slug": "frederiksborgvej-38d-4000-2-4", "floor": "2", "door": "4", "apartment_number": 48, "use_code": "140", "dwelling_type": "1", "area_bbr_m2": 51, "area_registered_m2": 46, "rooms": 1 } ], "source": "BBR (the unit register) and DAR, our copy; floor and door as BBR and the unit pages hold them, null where they hold none" }

/travel

Rejsen mellem to adresser i ét kald: {address} er starten og to (påkrævet, én gang) er den anden ende; begge er et adresse-id eller en slug (eller en enheds-slug), som på de andre ruter. car, bike og walk har hver available, minutes og km. Bilens tid er vejnettets frie køretid ved hastighedsgrænserne: uden trafik, uden køer og uden ventetid ved betalingsanlægget (time_basis). Cykel regnes med 15 km/t og gang med 4,7 km/t, på veje der er åbne for dem (ingen motorvej eller motortrafikvej). straight_line_km er afstanden i fugleflugt, og from og to er det samme address-svar som på alle ruter, med latitude og longitude.

Vejafgift. car.tolls viser hver betalingsbro, bilruten kører over, med varebilens listepris pr. køretøjsklasse (Sund & Bælts egen prisliste, med link i source_url og den dag, vi læste den, i read_on). Denne version kender én afgift, Storebæltsbroen, og genkender den på selve ruten; en tom liste betyder, at ruten ikke krydser nogen af de afgifter, vi kender. Listeprisen er prisen for én enkeltur, med moms, for en betaler med kort eller kontanter; Bizz- og nummerpladeprisen, den grønne rabat og aftalerne er ikke regnet med (price_note).

Kilder. Vejdata: Road data © OpenStreetMap contributors (ODbL) (openstreetmap.org/copyright); samme tekst står i svarets source. Vejafgiften: Sund & Bælts side Prices and discounts for business customers (storebaelt.dk), læst 18.11.2026; hver afgift har den i car.tolls[].source, source_url og read_on.

Færger er ikke med endnu. Et par, der kræver en færge (en ø uden bro, fx Bornholm), svarer available: false med unavailable_code no_route og en sætning på klart sprog, aldrig en fejl. Det gør en cykel- eller gangrute over Storebælt også: broen er lukket for begge.

Tæller som ét bbr-opslag pr. par. Gratis og aldrig talt: et par uden rute i nogen form, den samme adresse to gange og et 202. En rute, der tager mere end nogle få sekunder, svarer 202 route_computing med retry_after_seconds og en Retry-After-header og gemmes: send samme forespørgsel igen, så svarer den straks. Begge ender prøves som på alle adresseruter; en adresse, vi ikke har eller ikke må vise, giver 404 unknown_address, og for to er svaret det samme i begge tilfælde.

{ "from": { "id": "0a3f507a-ac29-32b8-e044-0003ba298018", "slug": "kongens-nytorv-13-1050", "street": "Kongens Nytorv", "number": "13", "postcode": 1050, "city": "København K", "municipality_code": "0101", "municipality_name": "København", "latitude": 55.67916, "longitude": 12.58484, "parcel_number": "428", "cadastral_district_code": "2000181", "null_reasons": {} }, "from_unit": null, "to": { "id": "0a3f5096-c91e-32b8-e044-0003ba298018", "slug": "raadhuspladsen-1-8000", "street": "Rådhuspladsen", "number": "1", "postcode": 8000, "city": "Aarhus C", "municipality_code": "0751", "municipality_name": "Aarhus", "latitude": 56.15337, "longitude": 10.20293, "parcel_number": "352", "cadastral_district_code": "2006351", "null_reasons": {} }, "to_unit": null, "straight_line_km": 158.0, "car": { "available": true, "minutes": 162, "km": 302.8, "time_basis": "without traffic", "tolls": [ { "name": "Storebæltsbroen", "operator_name": "Sund & Bælt", "crossings": 1, "van_prices": [ { "vehicle": "Van up to 6 m long", "list_price_dkk": 235 }, { "vehicle": "Van with trailer up to 6 m total length", "list_price_dkk": 235 }, { "vehicle": "Van over 6 m long and under 2.7 m high", "list_price_dkk": 360 }, { "vehicle": "Van with trailer over 6 m total length and under 2.7 m high", "list_price_dkk": 360 }, { "vehicle": "Van over 6 m long and over 2.7 m high", "list_price_dkk": 645 }, { "vehicle": "Van with trailer over 6 m total length and over 2.7 m high", "list_price_dkk": 645 } ], "price_basis": "Price list 2026 (effective 1 January 2026), one way, including 25 % VAT", "price_note": "The list price is what the toll station charges a card or cash payer. Not applied: the lower Bizz and number-plate prices, the green discount, Storebælt agreements, the commuter discount and the weekend, evening and public-holiday tickets. Prices change on 1 January: `read_on` is the day we read the operator's list.", "source": "Sund & Bælt, \"Prices and discounts for business customers\", https://www.storebaelt.dk/en/prices-and-discounts/business/, read 2026-11-18", "source_url": "https://www.storebaelt.dk/en/prices-and-discounts/business/", "read_on": "2026-11-18" } ], "tolls_checked": [ "Storebæltsbroen" ], "unavailable_code": null, "unavailable_reason": null }, "bike": { "available": false, "minutes": null, "km": null, "unavailable_code": "no_route", "unavailable_reason": "No bike route: the Great Belt Bridge is closed to bikes and ferries are not included yet." }, "walk": { "available": false, "minutes": null, "km": null, "unavailable_code": "no_route", "unavailable_reason": "No walking route: the Great Belt Bridge is closed to pedestrians and ferries are not included yet." }, "notes": [ "Car minutes are the road network's own free-flow time at the speed limits: without traffic, queues or waiting at a toll station. Bike is 15 km/h and walking 4.7 km/h, on roads open to them (no motorway or trunk road).", "Road figures run between the road-network point nearest each address. They cross water only on bridges and tunnels: ferries are not included yet, so a pair that needs one has no route.", "Tolls: this version knows Storebæltsbroen (the Great Belt Bridge) only. car.tolls lists the crossings the car route makes; an empty list means none of the tolls we know. The van price is a list price, see price_note." ], "source": "Road data © OpenStreetMap contributors (ODbL), routed by pgRouting. Toll prices: Sund & Bælt's price list for business customers, see car.tolls[].source and read_on" }

/land-registry (kun Data + Tingbog)

Tinglysning er kun med i planen Data + Tingbog. En Data-nøgle får 403 plan_does_not_include_route (gratis, tæller ikke, uanset hvilken adresse der er nævnt); Data-kunder får salgspriserne og -datoerne på /sales i stedet. status er held (vi har posten; copy_date er datoen på VORES kopi) eller not_available_yet. Vi kalder aldrig registret midt i jeres kald, og kopien opdateres kun, når forbindelsen til registret tillader det - tjek copy_date. charges: type, amount_dkk, interest_rate, max_interest_rate_pct, interest_rate_status, loan_type, priority, registered og lender (navn og CVR, når långiveren er et selskab; en privatperson som långiver er en part, se nedenfor), og debtors (hæftelsens debitorer som parter). owners er ejerne af kopien. En part har kind (person, company eller unknown: en part, registret nævner som en enhed uden CVR-nummer, fx en bankfilial; den har intet cvr, og navnet er højst 24 timer gammelt som en persons), name, cvr (kun en virksomhed), share (numerator, denominator) og name_status: given, withheld_by_register (registret oplyser intet navn, fx for en person, registret selv maskerer), not_read (en ejer, vi ikke har kunnet læse i kopien: hullet er vores, ikke registrets) eller withheld_copy_older_than_24_hours. Et adressebeskyttet hjem navngives som alle andre. Blokken names siger, om navne er med (included, none_held eller withheld_copy_older_than_24_hours) og hvilken kopi de stammer fra (as_of). Navnene er til jeres egen interne brug til det oplyste formål efter § 50 c, må ikke bruges til at henvende jer til nogen og må ikke gives videre. interest_rate er renten på et realkreditlån og intet andet. På et ejerpantebrev og et privat pantebrev registrerer dokumentet en MAKSIMAL rente, som står i max_interest_rate_pct og aldrig i interest_rate; anden, udlæg og skadesløsbrev oplyser nul. interest_rate_status er stated, maximum_only, none_stated, not_held (vi har ikke værdien for denne hæftelse, uanset type: den er ikke læst fra registret for denne kopi; det betyder aldrig, at registret oplyser ingen rente) eller not_classified (en type vi ikke fortolker). Beløb er som tinglyst: en omlagt hæftelse står, til den aflyses, så hæftelser er ikke gæld, og beløb på tværs af typer må ikke lægges sammen. shared_across_properties ikke null betyder, at ét dokument dækker så mange ejendomme. Hver hæftelse har også amount og currency (registrets beløb i registrets egen valuta; amount_dkk er null for en hæftelse i anden valuta end kroner), document_id og document_digital, special_terms (registrets egne vilkår), respected_rights_count (antallet af rettigheder, hæftelsen respekterer), first_pledge (amount og holder_cvr for den første underpant) og rate_details (type fast eller variabel, provisional og for et lån knyttet til en referencerente reference med name, rate_pct, margin_pct og margin_direction); rate_details ændrer aldrig interest_rate. Alle parter, registret nævner i hæftelsens dokument, står efter rolle: lenders, notified_parties, pledgees (med pledge_amount) og attorneys, ved siden af debtors; de følger samme regler som navnene ovenfor og er tomme, indtil vi har hentet ejendommen. transfers er registrets adkomster: type, registered, document_id, document_digital, takeover_date, de beløb skødet oplyser (cash_price_dkk, total_price_dkk, inheritance_or_gift_dkk, assumed_arrears_dkk; null, hvor skødet ingen oplyser) og skødets owners. En servitut har foruden title også text (registrets egen ordlyd, som kan nævne en person og bruges som navnene ovenfor), document_id, document_alias og document_digital. sales er købesum og dato fra EJF, ikke Tinglysning. Obligationsserie og årgang indgår ikke i de data, vi har.

I dag har vi hæftelser og servitutter liggende klar for 7.727 ejendomme, nyeste kopi 19.11.2026. En ejendom, vi ikke har, hentes fra tinglysningen, når I bestiller; svaret er klart efter få minutter.

{ "address": { "id": "bcd4669f-0f02-44db-ae76-2db26c63bdb3", "slug": "strandby-have-22-2670", "street": "Strandby Have", "number": "22", "postcode": 2670, "city": "Greve", "municipality_code": "0253", "municipality_name": "Greve", "latitude": 55.59517, "longitude": 12.33795, "parcel_number": "3dø", "cadastral_district_code": "40652", "null_reasons": {} }, "property": { "bfe": 100553324, "how_resolved": "matrikel", "candidates": 1, "addresses_on_property": 1, "unit": null }, "status": "held", "source": "Tinglysning (Den Digitale Tingbog), our stored copy: never fetched during your call", "copy_date": "2026-08-12T19:43:56.083353Z", "fresh": false, "charges": [ { "type": "realkreditpantebrev", "amount_dkk": 8548000, "interest_rate": 4.2724, "max_interest_rate_pct": null, "interest_rate_status": "stated", "loan_type": "kontantlaan", "priority": 5, "registered": "2025-01-13", "lender": { "name": "DLR KREDIT A/S", "cvr": "25781309" }, "lender_is_person": false, "shared_across_properties": 6, "debtors": [], "lenders": [], "notified_parties": [], "pledgees": [], "attorneys": [], "amount": 8548000, "currency": "DKK", "document_id": "72cc4f4a-c90c-4f7b-babe-876953044736", "document_digital": true, "special_terms": null, "respected_rights_count": 4, "first_pledge": null, "rate_details": null }, { "type": "realkreditpantebrev", "amount_dkk": 8901000, "interest_rate": 4.0, "max_interest_rate_pct": null, "interest_rate_status": "stated", "loan_type": "obligationslaan", "priority": 6, "registered": "2025-01-13", "lender": { "name": "DLR KREDIT A/S", "cvr": "25781309" }, "lender_is_person": false, "shared_across_properties": 6, "debtors": [], "lenders": [], "notified_parties": [], "pledgees": [], "attorneys": [], "amount": 8901000, "currency": "DKK", "document_id": "dec029fc-eba7-432c-9371-05a37f2ad356", "document_digital": true, "special_terms": null, "respected_rights_count": 5, "first_pledge": null, "rate_details": null }, { "type": "ejerpantebrev", "amount_dkk": 5100000, "interest_rate": null, "max_interest_rate_pct": null, "interest_rate_status": "not_held", "loan_type": null, "priority": 7, "registered": "2025-01-13", "lender": { "name": "Strandby Have ApS", "cvr": "44619466" }, "lender_is_person": false, "shared_across_properties": 6, "debtors": [], "lenders": [], "notified_parties": [], "pledgees": [], "attorneys": [], "amount": 5100000, "currency": "DKK", "document_id": "ffc95bba-c232-4557-8a9a-4b110556ce36", "document_digital": true, "special_terms": null, "respected_rights_count": 6, "first_pledge": { "amount": 5100000, "holder_cvr": "45801012" }, "rate_details": null } ], "owners": [], "transfers": [ { "type": "skoede", "registered": "2024-11-04", "document_id": "8fba615e-ab1f-4a75-a206-aceb333c049c", "document_digital": true, "takeover_date": "2025-01-22", "cash_price_dkk": 4375000, "total_price_dkk": 4375000, "inheritance_or_gift_dkk": null, "assumed_arrears_dkk": null, "owners": [] } ], "names": { "status": "withheld_copy_older_than_24_hours", "as_of": "2026-08-12T19:43:56.083353Z" }, "sales": { "source": "EJF (Ejerfortegnelsen) via our sold-homes table; not Tinglysning", "truncated": false, "items": [ { "takeover": "2025-01-22", "agreement": "2024-02-26", "price_dkk": 4375000, "transfer_type": "Almindelig fri handel", "addresses_on_deal": 1, "price_covers_several_properties": false, "plausible": true } ] }, "easements": [ { "title": "Deklaration", "type": "andenServitut", "registered": "1999-09-17", "priority": 1, "categories": null, "affects_value": false, "text": "Dekl. om vandledning og regnvandsledning mv", "document_id": "a55fda10-9b3e-44dd-bbc2-7e15cb5b15d2", "document_alias": "19990917-71073-18", "document_digital": false }, { "title": "Anden servitut", "type": "andenServitut", "registered": "2021-11-09", "priority": 2, "categories": [ "Anvendelse", "Bebyggelse" ], "affects_value": false, "text": null, "document_id": "7b1a53f4-a10e-4663-a751-bd7cc6317e05", "document_alias": null, "document_digital": true }, { "title": "Anden servitut", "type": "andenServitut", "registered": "2021-11-09", "priority": 3, "categories": [ "Anvendelse" ], "affects_value": false, "text": null, "document_id": "763c7b15-1c06-4f4b-b1f0-5c4f56dc389d", "document_alias": null, "document_digital": true }, { "title": "Anden servitut", "type": "andenServitut", "registered": "2023-09-12", "priority": 4, "categories": [ "Bebyggelse" ], "affects_value": false, "text": null, "document_id": "aea41f63-b4e6-4dfe-aa9c-5294dade4aa3", "document_alias": null, "document_digital": true } ], "truncated": { "charges": false, "easements": false } }

Har vi ikke ejendommen endnu, bestiller kaldet den og venter op til 8 sekunder på posten; de fleste bestillinger svarer med held i samme kald. Er vores kopi ældre end 24 timer, serverer vi den ikke som aktuel: kaldet bestiller en ny på samme måde, så også en ejendom, I har set før, kan svare 202 første gang, og det tæller som ét opslag. Eksemplet ovenfor er et held-svar fra en optagelse, og dens copy_date er ældre end 24 timer: kalder I selv samme adresse, får I først 202 ordered og derefter held med en ny copy_date. Ellers svarer det 202: ordered (kaldet bestilte, new_order: true) eller ordered_still_waiting (en bestilling af ejendommen ligger allerede i køen, fra jer eller en anden nøgle: den slås sammen med den, ét opslag og ét træk). reason siger hvorfor den venter: queued, being_fetched, retrying (registret svarede dårligt, vi prøver igen af os selv), court_rate_limited (registret bad os sætte farten ned), court_maintenance (annonceret servicevindue) eller court_unavailable (registret svarer ikke; bestillingen bliver stående). attempt, max_attempts, next_attempt_at og retry_after_seconds siger, hvornår næste forsøg er. I skal ikke selv prøve igen andet end at spørge igen, og det er gratis. Ender bestillingen uden post, svarer kaldet 200 order_failed med reason og refunded: opslaget, der blev trukket ved bestillingen, lægges tilbage på nøglen af sig selv inden for få sekunder. Der er ingen ventetid på en time; et nyt kald bestiller igen (efter 60 sekunder, og efter en time, hvis registret ikke kender ejendommen).

{ "address": { "id": "bcd4669f-0f02-44db-ae76-2db26c63bdb3", "slug": "strandby-have-22-2670", "street": "Strandby Have", "number": "22", "postcode": 2670, "city": "Greve", "municipality_code": "0253", "municipality_name": "Greve", "latitude": 55.59517, "longitude": 12.33795, "parcel_number": "3dø", "cadastral_district_code": "40652", "null_reasons": {} }, "property": { "bfe": 100553324, "how_resolved": "matrikel", "candidates": 1, "addresses_on_property": 1, "unit": null }, "status": "ordered", "new_order": true, "reason": "retrying", "ordered_at": "2026-11-17T09:12:44.103Z", "attempt": 2, "max_attempts": 6, "next_attempt_at": "2026-11-17T09:12:59.250Z", "retry_after_seconds": 15, "message": "The register did not answer well; we try again by ourselves, there is nothing for you to do. Ask again after retry_after_seconds; asking again costs nothing, and a record that cannot be fetched is not charged." }
{ "address": { "id": "bcd4669f-0f02-44db-ae76-2db26c63bdb3", "slug": "strandby-have-22-2670", "street": "Strandby Have", "number": "22", "postcode": 2670, "city": "Greve", "municipality_code": "0253", "municipality_name": "Greve", "latitude": 55.59517, "longitude": 12.33795, "parcel_number": "3dø", "cadastral_district_code": "40652", "null_reasons": {} }, "property": { "bfe": 100553324, "how_resolved": "matrikel", "candidates": 1, "addresses_on_property": 1, "unit": null }, "status": "order_failed", "reason": "retries_exhausted", "ordered_at": "2026-11-17T09:12:44.103Z", "refunded": true, "retry_after_seconds": 54, "message": "The fetch for this property ended without a record. The unit it used has been given back to your key. A new order is placed by your next call after retry_after_seconds; asking before that costs nothing and orders nothing." }

/land-registry/documents/{document_id} (kun Data + Tingbog)

Registrets eget dokument bag en hæftelse, en servitut eller en adkomst, som PDF, præcis som registret giver det; ældre dokumenter er scanninger. Tag document_id fra /land-registry-svaret for samme adresse: det står på hver post i charges, easements (med document_alias, registrets gamle dato-løbenummer) og transfers. document_digital siger, om dokumentet er tinglyst fra 2009; det afviser ikke noget. Et id, som ikke hører til ejendommen, giver 404 unknown_document (gratis).

Har vi en kopi under 24 timer gammel, svarer kaldet straks med PDF'en (Content-Type: application/pdf, med X-Document-Copy-Date og X-Document-Sha256). Ellers bestiller kaldet dokumentet og venter op til 8 sekunder på det; de fleste kald svarer med PDF'en i samme kald. Ellers svarer det 202 (ordered eller ordered_still_waiting) med reason (queued, being_fetched, retrying, court_rate_limited, court_maintenance, court_unavailable), attempt, next_attempt_at og en retry_after_seconds fra køens egen tilstand, og det samme kald igen svarer PDF'en. Ender bestillingen uden dokumentet, svarer kaldet 200 som JSON med status: order_failed, en reason (document_not_available, cancelled, too_large, court_unavailable, retries_exhausted, court_no_document, register_error, nothing_stored, internal_error) og refunded, og opslaget gives tilbage af sig selv; et dokument, der er leveret, bliver aldrig givet tilbage. court_no_document betyder, at registret ikke leverer dokumentet (som regel ældre dokumenter, fra før 2009): det svarer fejl to gange i træk, mens det svarer på alt andet, og så ender bestillingen med det samme i stedet for at vente, og opslaget gives tilbage. Det er hverken din eller vores fejl, og en ny bestilling giver som regel det samme svar. Samme dokument kan bestilles igen efter 60 sekunder. Et dokument tæller som ét land_registry-opslag pr. nøgle pr. 24 timer, uanset om PDF'en kom fra vores kopi eller fra registret.

{ "address": { "id": "bcd4669f-0f02-44db-ae76-2db26c63bdb3", "slug": "strandby-have-22-2670", "street": "Strandby Have", "number": "22", "postcode": 2670, "city": "Greve", "municipality_code": "0253", "municipality_name": "Greve", "latitude": 55.59517, "longitude": 12.33795, "parcel_number": "3dø", "cadastral_district_code": "40652", "null_reasons": {} }, "property": { "bfe": 100553324, "how_resolved": "matrikel", "candidates": 1, "addresses_on_property": 1, "unit": null }, "document_id": "a55fda10-9b3e-44dd-bbc2-7e15cb5b15d2", "status": "ordered", "new_order": true, "reason": "retrying", "ordered_at": "2026-11-17T09:12:44.103Z", "attempt": 2, "max_attempts": 6, "next_attempt_at": "2026-11-17T09:12:59.250Z", "retry_after_seconds": 15, "message": "The register did not answer well; we try again by ourselves, there is nothing for you to do. Ask again after retry_after_seconds; asking again costs nothing, and a document that cannot be fetched is not charged." }

/bbr

buildings, units og plots, hver med BBR's egne danske feltnavne i record. at_this_address markerer de bygninger, BBR knytter til netop denne adresse; resten deler matriklen. Lister er begrænset (200 / 500 / 50), og truncated viser, at grænsen blev nået.

Fakta (facts) står ved siden af record på hver bygning, enhed og grund; intet er fjernet. Hvert faktum er {code, label, value, value_code, as_of}: code er BBR's feltnummer (fx byg056), label BBR's eget danske feltnavn, value et tal for et talfelt eller BBR's officielle tekst for kodens værdi (null, hvis koden ikke findes på BBR's liste), value_code den rå kode (null for et tal) og as_of datoen, posten blev registreret i BBR. Et negativt tal er intet tal (BBR skriver -1 for «ikke registreret»; enheder, der ikke længere findes, har dem): så er enhedens total_area_m2, residential_area_m2 og rooms null med en sætning i enhedens null_reasons, et talfaktum er null med null_reason, og record har registrets egen værdi (se eksemplet under afsnittet: en enhed, der ikke længere findes, med opfundne id'er). Bygning: anvendelse, opførelsesår, om-/tilbygningsår, arealer, antal etager, varmeinstallation, supplerende varme, vandforsyning, afløb, ydervæggens materiale og tagdækning; enhed: anvendelse, arealer og antal værelser; grund: vandforsyning og afløb. Et felt, BBR ikke har for posten, er udeladt. Ordene er BBR's officielle kodelister (teknik.bbr.dk/kodelister). Energimærkets rapport-link kan vi ikke give: vores kopi af registret har ikke certifikatnummeret; energy_label.label_id er mærkets nummer.

{ "units": [ { "id": "5c0b7d52-3a41-4e0e-9a8e-6d2f4b1c9a07", "building_id": "9f1d2c7e-6b3a-4c58-8e21-0a7b5d4c3e19", "use_code": "140", "dwelling_type": null, "total_area_m2": null, "residential_area_m2": null, "rooms": null, "status": "9", "unit_id": "5c0b7d52-3a41-4e0e-9a8e-6d2f4b1c9a07", "unit_slug": null, "null_reasons": { "total_area_m2": "BBR holds a negative number in this field (-1 is the register's placeholder for \"not registered\"), which is no figure: we give null. The register's own value stays in `record`.", "residential_area_m2": "BBR holds a negative number in this field (-1 is the register's placeholder for \"not registered\"), which is no figure: we give null. The register's own value stays in `record`.", "rooms": "BBR holds a negative number in this field (-1 is the register's placeholder for \"not registered\"), which is no figure: we give null. The register's own value stays in `record`." }, "facts": [ { "code": "enh026", "label": "Enhedens samlede areal", "value": null, "value_code": null, "as_of": "2024-03-02", "null_reason": "BBR holds a negative number in this field (-1 is the register's placeholder for \"not registered\"), which is no figure: we give null. The register's own value stays in `record`." }, { "code": "enh027", "label": "Areal til beboelse", "value": null, "value_code": null, "as_of": "2024-03-02", "null_reason": "BBR holds a negative number in this field (-1 is the register's placeholder for \"not registered\"), which is no figure: we give null. The register's own value stays in `record`." }, { "code": "enh031", "label": "Antal værelser", "value": null, "value_code": null, "as_of": "2024-03-02", "null_reason": "BBR holds a negative number in this field (-1 is the register's placeholder for \"not registered\"), which is no figure: we give null. The register's own value stays in `record`." } ], "record": { "enh026EnhedensSamledeAreal": -1, "enh027ArealTilBeboelse": -1, "enh031AntalVærelser": -1, "status": "9", "registreringFra": "2024-03-02T09:00:00.000000+01:00" } } ] }

Byggeret er med i opslaget uden ekstra pris: building_right har det, vi ud fra planen mener, der kan bygges, som i det åbne API: remaining_floor_area_m2 (med fortegn: negativ betyder, at huset allerede er bygget ud over planen), allowed_floor_area_m2, status og indicative (sand, når procenten er BR18-standarden og ikke en plans). notes er beregningens forbehold, hver som en code med parameters og en engelsk sætning, og not_calculated giver en kode og en sætning, når der ikke er noget tal. plan er den plan, procenten kommer fra: level (local_plan, local_plan_area eller municipal_plan_frame; en kommuneplanramme er et loft for kommunens afgørelse, ikke en ret), plan_number, plan_name (planens eget navn, som registret har det), adopted_year og document_url (planen på plandata.dk), og height_limit_m er den højdegrænse, planen sætter, i meter; max_floors er det højeste antal etager, samme plan angiver (1,5 betyder halvanden etage), og min_plot_m2 den mindste grundstørrelse ved udstykning i m². BR18-standarden, en kolonihave og en adresse uden planpost har null begge steder. Intet felt er dansk tekst; hvad der mangler, er null, og building_right.null_reasons siger hvorfor.

Oversigt er med i opslaget uden ekstra pris: summary har de tal, adressesiden viser, med dens regler og de samme værdier som i det åbne API, på engelsk: home_type (house, flat, other), main_use_code, built_year, rebuilt_year, dwelling_area_m2, property_dwelling_area_m2 (ejendommens samlede boligareal, kun for et hus på en ejendom med flere boliger), building_area_m2, built_up_area_m2, building_count, dwellings_on_property, plot_area_m2 og shared_parcel_addresses. Et tal, vi ikke kan stå inde for, er null, og summary.null_reasons siger hvorfor. record er registret, som det står, og kan afvige fra oversigten.

Energimærke er med i opslaget uden ekstra pris: energy_label for adressen og buildings[].energy_label pr. bygning, hvor registret oplyser det. Feltet har letter (A-G), register_class (registrets egen klasse, fx A2020), valid_from, valid_to, valid, certificate_number (registrets eget energimærkenummer, 9 cifre; label_id er den samme værdi og bliver stående) og applies_to: this_building, eller neighbour_building med distance_m og en caveat, når adressen ikke har sit eget mærke og det nærmeste inden for 50 m står i stedet. Er der intet mærke, er felterne null, og null_reason siger hvorfor. Mærket vælges efter samme regel som i det åbne API, så bogstavet er det samme begge steder.

{ "address": { "id": "bcd4669f-0f02-44db-ae76-2db26c63bdb3", "slug": "strandby-have-22-2670", "street": "Strandby Have", "number": "22", "postcode": 2670, "city": "Greve", "municipality_code": "0253", "municipality_name": "Greve", "latitude": 55.59517, "longitude": 12.33795, "parcel_number": "3dø", "cadastral_district_code": "40652", "null_reasons": {} }, "unit": null, "source": "BBR (Datafordeleren), our copy; fields are the register's own names", "energy_label": { "letter": "A", "register_class": "A2015", "valid_from": "2025-01-14", "valid_to": "2035-01-14", "valid": true, "label_id": "311805799", "certificate_number": "311805799", "applies_to": "neighbour_building", "distance_m": 24, "caveat": "This is the label of a neighbouring building about 24 m from the address, not of the address's own building.", "null_reason": null, "source": "Energistyrelsen energy label register (EMOData), our copy; the label is chosen by the same rule as the free /api/adresse answer (docs https://grundviden.dk/om/kilder)" }, "summary": { "scope": "address", "home_type": "house", "main_use_code": "131", "built_year": 2025, "rebuilt_year": null, "dwelling_area_m2": 132, "property_dwelling_area_m2": null, "building_area_m2": 132, "built_up_area_m2": 90, "building_count": 3, "dwellings_on_property": 1, "plot_area_m2": 188, "shared_parcel_addresses": null, "null_reasons": { "rebuilt_year": "We have no year of rebuilding: BBR registers no extension or conversion on the address's building, or no building is tied to the address.", "property_dwelling_area_m2": "Only given for a house on a property with several homes, where the sum says more than dwelling_area_m2.", "shared_parcel_addresses": "Only set for a large shared plot without homes, such as an allotment or marina harbour; otherwise not relevant for the address." }, "source": "BBR (Datafordeleren) and the land register, through the address page's own model: the same figures as the free /api/adresse bbr block (docs https://grundviden.dk/om/kilder)", "note": "The figures the address page prints, with its rules: only standing buildings (BBR status 6 and 7), the home is the building BBR ties to the address, a property with several homes has its own figure and a labelled total, a figure we do not count is null. The raw register records in buildings, units and plots are as stored and can differ." }, "building_right": { "scope": "address", "calculated": true, "remaining_floor_area_m2": -57, "allowed_floor_area_m2": 75, "status": "blocked", "indicative": true, "plan": null, "height_limit_m": null, "max_floors": null, "min_plot_m2": null, "notes": [ { "code": "protection_zone", "note": "The plot lies in a protection zone (forest building line) - the building right requires a dispensation, in practice often 0.", "parameters": { "zones": [ "forest_building_line" ] } }, { "code": "flood_erosion_area", "note": "In a flood or erosion area - the local plan may set requirements.", "parameters": null }, { "code": "default_coverage_percentage", "note": "The coverage percentage is the BR18 default (section 170, subsection 2), not one set in a local plan.", "parameters": { "regulation": "BR18", "section": 170, "subsection": 2 } }, { "code": "floor_area_is_bbr_proxy", "note": "The existing floor area is a BBR proxy; basement, a height-limit plan, distance to the neighbour's wall and easements are not counted.", "parameters": null } ], "not_calculated": null, "null_reasons": { "not_calculated": "The building right was calculated for this address, so there is nothing to explain.", "plan": "No local plan or municipal plan frame sets the percentage behind this building right (the BR18 default is used, or the plan record is not held), so there is no plan to name.", "height_limit_m": "The plan behind this building right states no height limit for the address, or no plan sets the percentage.", "max_floors": "The plan behind this building right states no maximum number of floors for the address, or no plan sets the percentage.", "min_plot_m2": "The plan behind this building right states no minimum plot size for the address, or no plan sets the percentage." }, "source": "Our building-right calculation (the plan's coverage percentage against the existing floor area), through the address page's own model: the same figures as the free /api/adresse byggeret block (docs https://grundviden.dk/om/kilder)" }, "buildings": [ { "id": "cbe97a32-1baa-4041-98ff-f28d21705e43", "status": "6", "use_code": "131", "at_this_address": true, "energy_label": { "letter": null, "register_class": null, "valid_from": null, "valid_to": null, "valid": null, "label_id": null, "certificate_number": null, "applies_to": null, "distance_m": null, "caveat": null, "null_reason": "The address has no label of its own (the label in energy_label is a neighbouring building's), so no building here has one.", "source": "Energistyrelsen energy label register (EMOData), our copy; the label is chosen by the same rule as the free /api/adresse answer (docs https://grundviden.dk/om/kilder)" }, "facts": [ { "code": "byg021", "label": "Bygningens anvendelse", "value": "Række-, kæde- og klyngehus", "value_code": "131", "as_of": "2025-01-22" }, { "code": "byg026", "label": "Opførelsesår", "value": 2025, "value_code": null, "as_of": "2025-01-22" }, { "code": "byg038", "label": "Samlet bygningsareal", "value": 132, "value_code": null, "as_of": "2025-01-22" }, { "code": "byg039", "label": "Bygningens samlede boligareal", "value": 132, "value_code": null, "as_of": "2025-01-22" }, { "code": "byg041", "label": "Bebygget areal", "value": 66, "value_code": null, "as_of": "2025-01-22" }, { "code": "byg054", "label": "Antal etager", "value": 2, "value_code": null, "as_of": "2025-01-22" }, { "code": "byg056", "label": "Varmeinstallation", "value": "Fjernvarme/blokvarme", "value_code": "1", "as_of": "2025-01-22" }, { "code": "byg032", "label": "Ydervæggens materiale", "value": "Mursten", "value_code": "1", "as_of": "2025-01-22" }, { "code": "byg033", "label": "Tagdækningsmateriale", "value": "Tagpap med lille hældning", "value_code": "1", "as_of": "2025-01-22" } ], "record": { "byg021BygningensAnvendelse": "131", "byg026Opførelsesår": 2025, "byg038SamletBygningsareal": 132, "byg039BygningensSamledeBoligAreal": 132, "byg041BebyggetAreal": 66, "byg054AntalEtager": 2, "byg056Varmeinstallation": "1", "byg032YdervæggensMateriale": "1", "byg033Tagdækningsmateriale": "1", "status": "6", "registreringFra": "2025-01-22T13:37:21.994676+01:00" } }, { "id": "8076115b-e1e5-4bb7-ad27-d53efd68eb67", "status": "6", "use_code": "920", "at_this_address": true, "energy_label": { "letter": null, "register_class": null, "valid_from": null, "valid_to": null, "valid": null, "label_id": null, "certificate_number": null, "applies_to": null, "distance_m": null, "caveat": null, "null_reason": "The address has no label of its own (the label in energy_label is a neighbouring building's), so no building here has one.", "source": "Energistyrelsen energy label register (EMOData), our copy; the label is chosen by the same rule as the free /api/adresse answer (docs https://grundviden.dk/om/kilder)" }, "facts": [ { "code": "byg021", "label": "Bygningens anvendelse", "value": "Carport", "value_code": "920", "as_of": "2025-01-22" }, { "code": "byg026", "label": "Opførelsesår", "value": 2025, "value_code": null, "as_of": "2025-01-22" }, { "code": "byg041", "label": "Bebygget areal", "value": 14, "value_code": null, "as_of": "2025-01-22" }, { "code": "byg032", "label": "Ydervæggens materiale", "value": "Træ", "value_code": "5", "as_of": "2025-01-22" }, { "code": "byg033", "label": "Tagdækningsmateriale", "value": "Tagpap med lille hældning", "value_code": "1", "as_of": "2025-01-22" } ], "record": { "byg021BygningensAnvendelse": "920", "byg026Opførelsesår": 2025, "byg041BebyggetAreal": 14, "byg032YdervæggensMateriale": "5", "byg033Tagdækningsmateriale": "1", "status": "6", "registreringFra": "2025-01-22T13:37:21.822790+01:00" } } ], "units": [ { "id": "dbaaeb00-0764-411f-bd34-a0ba29719b0c", "building_id": "cbe97a32-1baa-4041-98ff-f28d21705e43", "use_code": "131", "dwelling_type": "1", "total_area_m2": 132, "residential_area_m2": 132, "rooms": 4, "status": "6", "unit_id": "dbaaeb00-0764-411f-bd34-a0ba29719b0c", "unit_slug": null, "null_reasons": {}, "facts": [ { "code": "enh020", "label": "Enhedens anvendelse", "value": "Række-, kæde- og klyngehus", "value_code": "131", "as_of": "2025-12-14" }, { "code": "enh027", "label": "Areal til beboelse", "value": 132, "value_code": null, "as_of": "2025-12-14" }, { "code": "enh031", "label": "Antal værelser", "value": 4, "value_code": null, "as_of": "2025-12-14" } ], "record": { "enh020EnhedensAnvendelse": "131", "enh023Boligtype": "1", "enh027ArealTilBeboelse": 132, "enh031AntalVærelser": 4, "status": "6", "registreringFra": "2025-12-14T07:18:50.828624+01:00" } } ], "plots": [ { "id": "20f1dc69-51b9-404a-abdd-1da9880fa851", "parcel": null, "water_supply_code": null, "drainage_code": null, "status": "11", "facts": [], "record": { "status": "11", "registreringFra": "2025-01-22T13:35:27.073112+01:00" } } ], "truncated": { "buildings": false, "units": false, "plots": false } }

Tre opgaver, trin for trin

Eksemplerne har rigtig form, men opdigtede adresser, id'er, CVR-numre og tal: feltnavnene er de rigtige. $GV_KEY er jeres nøgle.

1. En lejlighed til salg: hvad koster den, og hvad tror vi, den er værd

Hent lejlighederne til salg. En side er 30 boliger og ét opslag:

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/homes \ --data-urlencode "m=salg" --data-urlencode "omr=postnr:2000" --data-urlencode "type=lejlighed"

En række i homes[], forkortet. Udbudsprisen (price_dkk) og vores afvigelse fra skønnet (deviation_pct, procent) står på rækken. id er annoncen, address_slug er bygningens adresse-slug (lejlighederne i en bygning deler den: fjern aldrig dubletter på den), og unit_slug er lejlighedens egen side eller null:

{ "id": 11234567, "address_slug": "eksempelvej-12-2000", "address": "Eksempelvej 12, 3. th, 2000 Frederiksberg", "status": "for_sale", "price_dkk": 4995000, "deviation_pct": -3, "area_m2": 87, "rooms": 3, "energy_label": "C", "agent": "Eksempel Bolig", "unit_slug": "eksempelvej-12-2000-3-th" }

Er unit_slug en tekst, spørger I om lejligheden. Svaret har estimate med kind: "dwelling" og tal og interval, eller kind: "unavailable" med withheld_reason, hvor lejlighedens side heller ikke viser et tal:

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/addresses/eksempelvej-12-2000-3-th/estimate
{ "address": { "slug": "eksempelvej-12-2000", "street": "Eksempelvej", "number": "12", "postcode": 2000 }, "unit": { "unit_id": "...", "slug": "eksempelvej-12-2000-3-th", "floor": "3", "door": "th", "bfe": 0 }, "estimate": { "kind": "dwelling", "expected_dkk": 5075000, "low_dkk": 4575000, "high_dkk": 5600000, "comparables": 40, "radius_m": 107 }, "source": "grundviden.dk ..." }

Er unit_slug null, spørger I om bygningen med rækkens address_slug som {address}:

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/addresses/eksempelvej-12-2000/estimate

Svaret gælder enten allerede den ene lejlighed, annoncen er knyttet til (resolved_from_listing med listing, note og resolved_by; tæller som ét opslag af den lejlighed), eller det er status: "choose_unit" som her. Så matcher I annoncens floor og door med units[].floor og units[].door; units[].listing_matches nævner de regler, der passer, og candidate_unit_ids de lejligheder, der ikke modsiger annoncen. Vi vælger ingen for jer. Spørg igen med den valgte lejligheds unit_slug (svaret for den kalder lejligheden unit.slug). choose_unit er gratis. Svaret har også units_range: laveste og højeste af de lejligheders egne skøn, siden viser for adressen (low_dkk, high_dkk, kr pr. m² i per_m2_low og per_m2_high), med priced_units af registered_units boliglejligheder; et spænd på tværs af lejligheder, ikke et skøn for bygningen. Er der ikke to prissatte lejligheder, er units_range null, og units_range_reason (no_flat_priced eller one_flat_priced) og units_range_note siger hvorfor.

{ "status": "choose_unit", "units": [ { "unit_slug": "eksempelvej-12-2000-3-th", "floor": "3", "door": "th", "area_bbr_m2": 87, "listing_matches": ["floor", "door"] }, { "unit_slug": "eksempelvej-12-2000-3-tv", "floor": "3", "door": "tv", "area_bbr_m2": 64 } ], "listings": [ { "listing_no": 11234567, "asking_price_dkk": 4995000, "floor": "3", "door": "th", "unit": { "status": "candidates", "candidate_unit_ids": ["..."] } } ], "units_range": { "priced_units": 8, "registered_units": 9, "low_dkk": 2150000, "high_dkk": 4300000, "per_m2_low": 31000, "per_m2_high": 49000 }, "units_range_reason": null }

2. Boliger til salg i et postnummer, der er udbudt under vores skøn

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/homes \ --data-urlencode "m=salg" --data-urlencode "omr=postnr:2000" \ --data-urlencode "afvmax=-1" --data-urlencode "sort=afv" --data-urlencode "side=1"

afvmax=-1 er inklusiv og i hele procent: boliger udbudt 1 % eller mere under skønnet (-1 er med, 0 er ikke). sort=afv sætter den laveste først (afvmax og sort=afv er parameternavne; feltet på rækken hedder deviation_pct). Området er omr=postnr:2000 (eller blot omr=2000); postnr=2000 er en 400, der nævner omr=postnr:2000. Bladr med side=1, 2, ..., til page er lig pages (en side efter den sidste svarer 200 med tom homes og koster intet). Hver side med boliger er ét opslag. Tjek på hver side, at total er den samme, og fjern dubletter på id (er det m=adr, på address_slug):

{ "total": 82, "page": 1, "pages": 3, "page_size": 30, "homes": [ { "id": 11234567, "deviation_pct": -19, "price_dkk": 3995000, "unit_slug": null }, "... 29 more rows, deviation_pct rising from -19 towards -1" ], "unknown_parameters": [], "interpreted": {}, "language_note": "...", "source": "..." }

3. Hvad ejer et selskab

Find CVR-nummeret med den betalte søgning. Et selskab i items har intet cvr-felt: nummeret står i url (/firma/<cvr>-<navn>), cifrene før den første bindestreg.

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/search --data-urlencode "q=Eksempel Ejendomme"
{ "items": [ { "url": "/firma/12345678-eksempel-ejendomme-aps", "tekst": "EKSEMPEL EJENDOMME APS", "type": "firma", "note": "2000" } ] }

/companies/{cvr} giver selskabets record (registerets danske feltnavne). /properties giver det, selskabet ejer direkte, 100 pr. side sorteret efter BFE: bladr med side, til page er lig pages; totalerne er total og without_address. Hver ejendoms address_slug (bygningen) eller, for en lejlighed, unit_slug er en {address} til adresse-endpoints. share er summen af de brøker, registret oplyser for selskabet på ejendommen, og kan være over 1 (ownership_records siger hvor mange poster): læs den ikke som en ejerandel i procent.

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/companies/12345678/properties --data-urlencode "side=1"
{ "company": { "cvr": 12345678, "name": "Eksempel Ejendomme ApS", "legal_form": "APS", "ceased": false }, "scope": "direct", "total": 324, "pages": 4, "page": 1, "page_size": 100, "without_address": 0, "properties": [ { "bfe": 1234567, "land_registry_path": "/api/v1/properties/1234567/land-registry", "lookup_key": "eksempelvej-12-2000-3-th", "address_slug": "eksempelvej-12-2000", "address": "Eksempelvej 12", "floor": "3", "door": "th", "unit_slug": "eksempelvej-12-2000-3-th", "share": 1.0, "ownership_records": 1, "last_transfer_date": "2023-02-01" } ], "withheld_reason": null }

scope=chain tager også det, selskaberne under det i ejerkæden ejer (højst ti led; et ophørt selskab er med og markeres ceased; selskaber, hvis form er en privatpersons, udelades og tælles i excluded_holders; et selskab, hvor intet register kan sige virksomhedsformen, er med og har legal_form null og legal_form_unknown sand). Samme svar med scope: "chain", holders (antal ejende selskaber) og to felter mere på hver ejendom:

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/companies/12345678/properties --data-urlencode "scope=chain"
{ "held_by": { "cvr": 87654321, "name": "Eksempel Datter ApS", "legal_form": "APS", "legal_form_unknown": false, "depth": 1, "ceased": false }, "held_via": [ { "cvr": 12345678, "name": "Eksempel Ejendomme ApS", "ceased": false }, { "cvr": 87654321, "name": "Eksempel Datter ApS", "ceased": false } ] }

Et selskabs ejendomme med deres hæftelser (to trin, kun Data + Tingbog)

Trin 1 er /properties ovenfor: hver række har land_registry_path. Trin 2 kalder den sti som den står (/api/v1/properties/{bfe}/land-registry), ét kald pr. ejendom. Kaldet tæller på loftet for tinglysningsopslag som ethvert andet opslag (samme ejendom igen inden for 24 timer er gratis, også hvis den slås op via adresse) og bestilles, hvis vi ikke har en kopi endnu. Stien nævner rækkens egen BFE, så den passer til alle rækker: en lejlighed, et hus, en bygning der ejes samlet og en ejendom uden adresse (without_address tæller dem). Svaret har ingen address-blok. lookup_key (lejlighedens egen slug, ellers adresse-slugget, null uden adresse) er til adresse-opslagene (/bbr, /estimate, /sales ...); bruger I den alligevel på /addresses/{address}/land-registry, så tjek at property.bfe i svaret er rækkens bfe (omkring 0,4 % af adressenøglerne ender på en anden ejendom: så brug ikke svaret), og en bygning, der ejes samlet, svarer choose_unit. Der er ingen samlet liste over et selskabs lån i ét kald.

curl -G -H "X-Api-Key: $GV_KEY" https://pro.grundviden.dk/api/v1/properties/1234567/land-registry
{ "status": "held", "property": { "bfe": 1234567, "how_resolved": "bfe" }, "copy_date": "2026-10-27T02:31:24Z", "charges": [ { "type": "realkreditpantebrev", "amount_dkk": 1696000, "priority": 2, "lender": { "name": "Eksempel Kredit A/S", "cvr": "12345679" } } ], "...": "easements, sales, notes" }

Hvad der tæller: /search og /units er hver ét opslag af kilden search; /companies/{cvr} og hver /properties-side tæller som kilden companies; et svar uden ejendomme er gratis. Et selskab, der er en enkeltmandsvirksomhed, en personligt ejet mindre virksomhed eller et dødsbo, svarer med tom liste og withheld_reason: person_owned_form: API'et viser ingen fysiske personers ejendomme.

Ordliste: felterne på en række i homes[]

Hvert felt, dets type og hvad det rummer. Feltnavne og værdier er de engelske, som API'et svarer med; beskrivelserne her er på dansk (llms.txt og OpenAPI-filen har dem på engelsk). Alle felter kan være null: en værdi, annoncen, registret eller vores model ikke giver, er null, aldrig en tom tekst eller 0.

FeltTypeBetyder
idintegerVores id for rækken: annoncens eget id, unikt pr. annonce. Med m=adr er rækken en adresse og ikke en annonce, og alle rækker har id 0: kend adresserækker på address_slug.
address_slugstringADRESSENS slug: send den som {address} til /addresses/{address}/... En bygnings lejligheder deler den; brug unit_slug for én lejlighed.
unit_slugstringSlug for lejlighedens egen side (gyldig som {address} også). Null, hvor annoncen ikke er knyttet til en lejlighedsside på adressen; spørg så /addresses/{address_slug}/estimate: den svarer choose_unit med bygningens enheder og annoncer.
addressstringVej, husnummer, postnummer og by som én linje (en lejligheds etage og dør er ikke med).
statusstringAnnoncens tilstand, som vi gemmer den: for_sale, eller rented for en lejeannonce, der er oppe; adresse med m=adr.
dwelling_typestringBBR's boligtype, som annoncen oplyser den (Villa, Ejerlejlighed, Rækkehus ...), med registrets danske ord.
villa_flatinteger1, hvor boligen er en villalejlighed (en lejlighed i et hus), ellers 0.
price_dkkintegerUdbudsprisen i kroner (en lejeannonce: den månedlige leje). Med m=adr: vores eget skøn for adressen. Null, når price_withheld er true.
price_per_m2_dkkintegerUdbudsprisen pr. kvadratmeter boligareal.
price_withheldbooleanTrue, hvor vi tilbageholder prisen efter adresseside-reglen (en pris, der dækker flere boliger, en andel); så er price_dkk null.
price_change_pctintegerUdbudsprisens seneste ændring i procent, med fortegn (en nedsættelse er negativ); null, hvor den ikke er ændret.
days_on_marketintegerAntal dage, boligen har været udbudt (samme tal som på siden); null, hvor starten ikke kendes.
area_m2integerBoligareal i kvadratmeter (BBR, eller annoncens, hvor den oplyser et).
roomsintegerAntal værelser (BBR, eller annoncens, hvor den oplyser et).
plot_m2integerGrundareal i kvadratmeter.
built_yearintegerÅret, bygningen er opført (BBR).
energy_labelstringEnergimærke A til G (annoncens, ellers registrets for ejendommen).
deviation_pctintegerUdbudsprisen mod vores skøn i procent, med fortegn: (udbudspris - skøn) / skøn, altså NEGATIV, hvor udbudsprisen ligger UNDER vores skøn, og positiv, hvor den ligger over. Null, hvor vi ikke vil kalde det (en pris, der dækker flere boliger, en afvigelse over 45 procent ...).
outside_estimate_rangebooleanTrue, hvor udbudsprisen ligger uden for vores skøns interval og ikke blot væk fra dets midte.
estimate_notestringHvor udbudsprisen ligger uden for vores skøns interval: vores skøn og dets interval som én engelsk sætning ("Our estimate: DKK 4,950,000 (DKK 4,700,000 - 5,200,000)"); ellers null.
agentstringMæglerbutikkens navn; null, hvor annoncens navn kan høre til annoncens egen mægler som person (ingen person nævnes).
urlstringAnnoncen på mæglerens egen side.
sale_formstringHvordan boligen sælges, hvor annoncen siger det (fx en buderunde), som annoncen skriver det.
bid_deadlinestringFristen for bud, DD.MM.ÅÅÅÅ.
open_housestringNæste åbent hus som DD.MM. at HH.MM-HH.MM (dansk tid; ordet "at" er engelsk, som i resten af API'ets egne ord, og eksemplet viser det); null, hvor intet er meldt ud.
sold_markstringHvor registret eller mægleren siger, at boligen er solgt: den engelske tekst "Sold - registered" med registreringsdatoen eller "Purchase agreement signed", ellers mæglerens eget statusord, som det står; null, hvor boligen ikke er solgt.
last_confirmed_notestringDagen, vi sidst så annoncen, DD.MM.ÅÅÅÅ, vist kun når det er 2 dage siden eller mere; null, hvor den er set i dag eller i går.
balconybooleanAnnoncen siger, at der er altan (true), eller intet er sagt (null). Aldrig false.
liftbooleanAnnoncen siger, at der er elevator (true), eller intet er sagt (null). Aldrig false.
pets_allowedbooleanAnnoncen siger, at husdyr er tilladt (true), eller intet er sagt (null). Aldrig false.
deposit_dkkintegerEn lejeannoncens depositum i kroner.
prepaid_rent_dkkintegerEn lejeannoncens forudbetalte leje i kroner.
aconto_dkkintegerEn lejeannoncens månedlige acontobetaling for varme og vand, i kroner.
available_fromstringEn lejeannoncens ledighedsdato, som siden skriver den.
available_nowbooleanEn lejeannonce: boligen er ledig nu.
dwellings_on_propertyintegerAntal boliger på ejendommen (BBR); 0, hvor det ikke kendes.
sea_viewintegerKlasse for havudsigt (vores terrænmodel): 1 til 3, null for ingen.
lake_viewintegerKlasse for søudsigt (vores terrænmodel), null for ingen.
noise_bandintegerStøjtrin for trafik 1 til 3 (Miljøstyrelsens kort), null for ingen.
livestock_nearbyintegerEn husdyrbedrift ligger nær boligen (vores afstandsberegning); null for ingen.
preservationintegerBygningens fredningsstatus, 1 til 2; null, hvor der ingen er.
soil_contamination_v1integerGrunden er kortlagt som jordforurening V1 (registret); null, hvor den ikke er.
soil_contamination_v2integerGrunden er kortlagt som jordforurening V2 (registret); null, hvor den ikke er.
vulnerable_areaintegerBoligen ligger i eller nær et område på regeringens liste over udsatte boligområder; null, hvor den ikke gør.
oil_tank_gradeintegerOlietankens grad 1 til 8 efter, hvor meget den bør bekymre en køber (vores gradering af BBR's tankfelter; 7 = i brug, boligen er ikke oliefyret; 8 = i brug, oliefyret og forbi den lovpligtige frist); null for ingen.
oil_tank_notestringDen ene sætning om ejendommens værste olietank, på engelsk (vores gradering af BBR's tankfelter); null, hvor der ingen er.
oil_tank_levelstringTankens bekymringsniveau som et ord: neutral, attention eller warning (sætningens alvor).
renovated_value_dkkintegerVores skøn over boligens værdi efter renovering til normal standard, ud fra boligens stand (renoveringscaset).
as_is_value_dkkintegerVores skøn over boligen, som den er (samme skøn, renovated_value_dkk er udledt af).
renovation_building_weightnumberBygningens andel af den offentlige vurdering, brugt af renoveringscaset.
sales_text_conditionintegerHvor slidt annoncens tekst siger, boligen er, fra -2 (trænger meget) til +2 (renoveret).
text_themesstringTemaer, salgsteksten nævner, som en kommasepareret liste af vores tema-id'er.
condition_wordsstringMæglerens egne ord om stand fundet i teksten, kommaseparerede.
agent_advertstringAnnoncens egen butiksstreng, præcis som mæglerens annonce har den (aldrig rettet); hvor `agent` er null, fordi navnet kan rumme annoncens egen enkelte mægler, er det stadig annoncens egen tekst. Null, hvor annoncen ingen har.
agent_words_advertstringAnnoncens egen formulering om flere boliger (fx "opdelt i to lejligheder"), uanset hvilke ord den rummer; null, hvor annoncens tekst ingen har.
deviation_pct_unfilteredintegerVores skøn mod udbudsprisen i procent, med fortegn som `deviation_pct`, hver gang begge tal findes: også hvor `deviation_pct` er null, fordi vi ikke vil kalde prisen høj eller lav (over 45 %, en annonce for flere boliger, spredte sammenlignelige salg). Lig `deviation_pct`, hvor den er givet. Null for en leje, for en udbudspris under 200.000 kr og uden skøn.
deviation_flagstringTilfældet, der gjorde `deviation_pct` null, mens `deviation_pct_unfiltered` er givet: `deviation_over_50_percent`, `deviation_over_45_percent`, `advert_covers_several_homes`, `scattered_comparables` eller `not_computed` (intet af de andre tilfælde passer: vores tal og udbudsprisen findes, men den gemte afvigelse mangler; koderne i `listing.deviation_reason` på adressesvaret). `deviation_over_45_percent` betyder en afvigelse på over 45 % i begge retninger (fortegnet står i `deviation_pct_unfiltered`); `deviation_over_50_percent` bruges kun for en udbudspris mere end 50 % OVER vores skøn, det ene tilfælde med sin egen regel (FarAbove: en udbudspris over 1,5 gange skønnet, som siden forklarer med de solgte boliger af samme slags); en pris langt under har ingen sådan regel og bliver ved med at være `deviation_over_45_percent`. Null, hvor `deviation_pct` er givet, eller der intet er at sammenligne.

Skøn og afvigelse: sådan er det lavet, og hvor godt det er

Skønnet er et sammenligningsskøn. Det tager udgangspunkt i registrerede frie handler (EJF, ikke udbudspriser) nær boligen de seneste ca. tre år, vægter de nærmeste og mest ens handler højest og regner på størrelse, grund, byggeår, energimærke og støj. En bolig, der selv er solgt inden for de seneste tre år, forankres i sit eget salg; for huse og sommerhuse blandes den offentlige vurdering ind; et sidste led justerer for kendte forhold som havudsigt, støj, opvarmning og det, registre og annoncens tekst siger om istandsættelse. Skønnet kender ikke boligens indre. low_dkk og high_dkk er intervallet om expected_dkk; hvor vi ikke står inde for et tal (fx fordi intervallet er for bredt), tilbageholder vi det og giver grunden (note, withheld_reason). Det er et skøn med et interval, ikke en vurdering.

deviation_pct (feltet afv på søgekortet; afv er stadig navnet på filtrene afvmax/afvmin og på sort=afv) er udbudsprisen mod vores skøn i hele procent: (udbudspris - skøn) / skøn. Negativ: udbudt under det, vi venter; positiv: over. På vores egne sider kaldes en bolig inden for 2 % til begge sider «på niveau med vores skøn». deviation_pct findes kun, hvor der er en annonce (m=salg) og et skøn. Det er en afstand til et modeltal, ikke en dom over boligen eller prisen.

Hvor godt er skønnet? Målt af os 15.11.2026: skønnet, som det stod før aftalen, mod den tinglyste pris på handler på armslængde, registreret 05.10.2026 - 08.11.2026 (fem uger; én adresse, en pris, ikke en andel af en samlet handel, der har bestået vores egen plausibilitetstest (prisen mod boligens eget tidligere salg inden for ti år, ellers mod det lokale niveau pr. m²; den ser aldrig på vores skøn)). Kun handler, vi havde et skøn for før aftalen, er med (første tal under hver type); resten er udeladt, fordi registret først kender en handel i median 45 dage efter aftalen (frie boligsalg registreret 01.07.2026 - 05.10.2026, 24.749 handler; i et kort vindue ser forsinkelsen kortere ud, fordi endnu uregistrerede handler mangler), og vores historik af skøn er kort.

Hvad «skønnet, som det stod» er: det tal, en læser blev vist den dag, og hvor intet var gemt som vist (historikkens første uger), modellens grundtal. Derfor er disse andele af de matchede handler målt mod grundtallet: Lejlighed: ingen; Rækkehus: 27 % (100 af 376); Parcelhus (villa): 25 % (565 af 2.268); Sommerhus: 7 % (53 af 755) (talt 15.11.2026 på en genopbygning dagen efter, så totalerne afviger op til ca. 1 % fra tabellen). For villaer er fortegnet (median) -1,4 % på det tal, en læser blev vist, og -9,1 % på grundtallet, og den typiske afvigelse 18,4 % og 16,4 %: fortegnet ovenfor blander de to, og «under prisen» passer bedre på grundtallet end på det, en læser så. Skønnet er det nyeste øjebliksbillede senest ved aftalen og højst 45 dage ældre, så det kan være op til 45 dage gammelt.

Sådan læses det: for en lejlighed ligger halvdelen af skønnene inden for 10 % af den betalte pris og tre fjerdedele inden for 20 %; for en villa er den typiske afvigelse ca. 18 %. Et deviation_pct på -5 på et hus ligger derfor inden for skønnets eget spillerum og er ikke et fund; en stor afvigelse er en grund til at se på boligen, ikke en dom om, at den er billig. I gennemsnit ligger skønnet under den betalte pris for huse og sommerhuse (fortegnet) og lidt over for lejligheder.

Det har vi ikke målt: om en bolig udbudt under vores skøn sælges billigere end andre, hvor langt udbudspriser ligger over de betalte priser, og nøjagtigheden pr. postnummer eller prisklasse. Læs ikke tallene ovenfor som nogen af delene.

Claude og ChatGPT

De samme ruter kan bruges som værktøjer i Claude og ChatGPT, uden nøgle: tilføj https://grundviden.dk/mcp som MCP-server med OAuth. Programmet sender jer til et login hos os og spørger, om det må bruge jeres konto; knapperne og trinene står under Nøgler. Hver rute er ét værktøj med samme svar som API'et (lookup_bbr er /bbr, list_homes er /homes og så videre, get_usage er /usage). Opslagene tæller, logges og begrænses som kald med en nøgle (også tinglysning kun på Data + Tingbog), men alle forbindelser fra Claude og ChatGPT deler én tæller pr. kilde pr. måned, adskilt fra jeres nøglers. I logningen står kanalen foran ruten (mcp:claude:bbr). I kan afbryde et program når som helst under Nøgler.

Kvoter

Pr. nøgle pr. kalendermåned (UTC): 1.000 tinglysningsopslag (kun Data + Tingbog), 100.000 BBR-opslag, 100.000 skøn og 100.000 sider af boliglisten. Hvert svar til en gyldig nøgle på et endpoint med en kilde (også et gratis 404) har X-Quota-Source, X-Quota-Limit, X-Quota-Used, X-Quota-Remaining (grænsen minus brugt, aldrig under 0) og X-Quota-Resets; et 401, et 403 og et 5xx har ingen, og det har /usage heller ikke (headerne gælder én kilde; svaret selv har grænse og forbrug for hver kilde i planen) eller en sti under /api/v1, der ikke findes (en 404 uden kilde). Ved loftet svarer API'et 429 monthly_cap_reached indtil nulstilling. Ukendte adresser og fejl tæller ikke.

Hvad tæller

Et svar fra /land-registry med status not_available_yet, der indeholder EJF-salg, tæller som ét land_registry-opslag; uden salg er det gratis. Et opslag med HEAD tæller aldrig.

Det samme opslag igen inden for 24 timer tæller kun én gang: på /land-registry pr. ejendom, på /land-registry/documents/{document_id} pr. dokument, på /bbr, /estimate, /listing-history, /comparables, /sales og /plan-rules pr. adresse (eller enhed) og på /travel pr. par af adresser. /sales tæller sammen med /estimate: har I læst den ene for en adresse, er den anden gratis i 24 timer. Det første opslag - eller bestillingen - er det, der tæller. Et skøn uden tal er gratis: svarer /estimate med estimate.withheld_reason (fx no_model_figure) og uden tal, tæller det ikke og starter heller ikke de 24 timer, så det næste svar med et tal tæller én gang; en bygning med flere lejligheder (several_flats) giver spændet af lejlighedernes tal og tæller. Ved loftet svarer API'et 429, før svaret er bygget, også for et skøn, der ville være blevet uden tal. Det samme gælder i Claude og ChatGPT. For en ejendom, vi ikke har, er det første kald det, der tæller: enten bestillingen, eller et svar med not_available_yet, der viser salg. Bestiller I inden for 24 timer efter et opslag, der allerede er talt, er bestillingen gratis. En bestilling, der slutter uden en post, giver sit opslag tilbage.

Alt andet tæller hver gang, også når det gentages: en side af /homes (30 boliger), et kald til /search eller /units, /companies og /companies/{cvr}, og hver side af /companies/{cvr}/properties (en gentaget side tæller igen). Gratis, og aldrig talt: en afvist forespørgsel (400), et ukendt selskab eller en ukendt adresse (404), en side efter den sidste af /homes eller /companies/{cvr}/properties (tom liste), en søgning i /homes uden resultat, et skøn uden tal (se ovenfor), et /travel-par uden rute i nogen form, og HEAD.

Grænse pr. minut, og kun fra servere

Hastighed: 1.000 kald pr. minut pr. kaldende IP-adresse (en IPv6 /64), for /usage og opslagene på samme måde. Over det svarer API'et 429 rate_limited som JSON i samme form som de andre fejl (detail.limit, detail.window_seconds, detail.scope) med Retry-After i sekunder. Det er adskilt fra månedens grænser.

Boliglisten har sin egen grænse pr. nøgle: højst 2 kald ad gangen og 60 i minuttet (429 rate_limited med detail.scope key_concurrency eller key). En side er 30 boliger og ét opslag.

v1 er kun til server-til-server: der sendes ingen CORS-headere, så en browser kan ikke kalde API'et fra en webside. Kald det fra jeres egen backend, og hold nøglen dér.

Testnøgle

På forespørgsel udsteder vi en testnøgle, der kun svarer på faste, opfundne testadresser fra faste svar: aldrig et rigtigt opslag, aldrig talt mod en grænse. Den svarer på alle de ruter, et forslagsfelt bruger: /search (med hver træfs struktur og limit), /addresses/resolve (exact for "testvej 1", 409 ambiguous for "testvej", none for en adresse, der ikke findes), /addresses/{address}/units, /addresses/{address}/bbr (med facts) og /addresses/{address}/estimate, i de rigtige svars form og med de rigtige ruters egne afvisninger (et parameternavn, ruten ikke læser, er den samme gratis 400), og hvert svar har headeren X-Fixture-Key: true. Alle andre ruter svarer 403 fixture_key_route. Testadresserne: testvej-1-9999 (et hus), testvej-3-9999 (et hus mere: søgeteksten "testvej" finder begge), testgade-2-9999 (en bygning med to enheder: testgade-2-9999-1-tv har en enhedsside, den anden, 1. th, nås med sit unit_id). Enhver anden adresse svarer 404 unknown_address.

Koder

use_code, status, dwelling_type, water_supply_code og de andre koder i svarene er BBR's egne. De officielle kodelister står på https://teknik.bbr.dk/kodelister.

Fejl

Fejl er JSON: error, message, detail.

400 invalid_requestEn parameter har en værdi, vi ikke kan læse, eller en kombination, vi ikke kan besvare (detail nævner den). Tæller ikke
400 invalid_cvrCVR-nummeret i stien er ikke otte cifre. Tæller ikke
401 invalid_keyManglende eller ugyldig nøgle
403 account_not_activeKontoen er ikke aktiveret (afventer eller stoppet)
404 unknown_addressAdressen findes ikke hos os (eller en enhed på den ligger i en bygning uden registreret indgang)
404 no_property_for_addressAdressen kan ikke knyttes til én ejendom
404 unknown_companyIntet selskab med det CVR-nummer. Tæller ikke
404 unknown_endpointStien findes ikke under /api/v1/
405 method_not_allowedStien findes, men svarer kun på GET
429 monthly_cap_reachedMånedens grænse for kilden er nået
429 rate_limitedFor mange kald fra samme IP-adresse på ét minut, eller på /homes for mange fra samme nøgle (se detail.scope); vent Retry-After sekunder
503 unavailableTjenesten kan ikke svare lige nu (databasen eller en afhængighed er nede, eller et opslag tog for lang tid); vent Retry-After sekunder og send det samme kald igen. Det er ikke en forkert forespørgsel

Typer, datoer og cache

Koder og registernøgler er tekst (municipality_code "0851", use_code, en långivers cvr). Antal, priser, arealer, postcode og bfe er tal. En kalenderdato er ÅÅÅÅ-MM-DD; et tidspunkt (copy_date, resets, headeren X-Quota-Resets) er ISO 8601 i UTC med Z. BBR's egne felter i record beholder registrets datoformat. Svarene sendes med Cache-Control: private, no-store: de er pr. nøgle og tælles, så de må ikke caches.

Brug og logning

Hvert opslag logges med konto, CVR, nøgle, adresse og tidspunkt, og på Data + Tingbog også med formålet. Tinglysningsopslag må kun ske til det formål, I har oplyst (tinglysningsloven § 50 c, stk. 9); Data spørger ikke efter et formål. Data fra opslagene og boliglisten er til jeres egen interne brug, inden for kvoterne; at vise den til andre, bruge den i et produkt eller en tjeneste for andre, give den videre eller sælge den videre kræver en skriftlig aftale med os (kontakt os). Videresalg og lister over ejere eller lån er ikke tilladt.

Hvem må I kontakte? Reglen står på Priser. Den følger datakilden, ikke planen: hvert virksomhedssvar har feltet advertising_protected. Vilkårene vises, når I tilmelder jer og bestiller, og I accepterer dem dér.