Alle kald er GET mod https://pro.grundviden.dk/api/v1/... og svarer JSON.
Giv den pro.grundviden.dk/llms.txt - én side med alt, den skal bruge - og OpenAPI-filen.
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.
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: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.
{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.
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.
/estimate, aldrig en boligpris. Båndet findes kun for kontor og butik i Københavns Kommune og kræver nok handler; findes der intet bånd, svarer /estimate kind: "unavailable" med withheld_reason: "no_band", den samme kode som /comparables giver for enheden. Båndet er et interval, ikke en vurdering: commercial_band.spread_factor er dets bredde (øvre ende divideret med nedre), og enhedens offentlige vurdering (public_valuation) står ved siden af som en anden reference. Totalen er båndet gange enhedens BBR-areal; mangler BBR et areal, bruges enhedens tinglyste areal, og commercial_band.area_source siger registered (noten siger det også). Et areal (BBR's eller det tinglyste) giver kun en total mellem 10 og 2.000 m², de størrelser båndet er bygget på: uden for dem er svaret kind: "unavailable" og withheld_reason: "area_out_of_range", med kvadratmeterprisen i commercial_band og uden total. Har enheden intet af de to arealer, er der intet at gange båndet med: kind: "unavailable" og withheld_reason: "no_area", uden tal./estimate kind: "unavailable" og withheld_reason: "no_unit_page", uden pris: vi finder ikke på en. Ved siden af står hele ejendommens offentlige vurdering (public_valuation, med public_valuation_scope): den er ejendommens, ikke enhedens. Har enheden intet eget ejerlejlighedsnummer i BBR, siger noten, at den ikke kan købes eller sælges for sig./land-registry får en enhed uden eget ejerlejlighedsnummer adressens ejendom: samme BFE, samme opslag og samme optælling som adressen (én gang pr. døgn), og svaret har en scope-linje om, at det er hele ejendommens. Det gælder kun, hvor adressen er knyttet til ejendommen via matriklen; i en etageejendom svarer en enhed uden nummer 404 no_property_for_address, gratis.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.
| Sti | Giver | Tæller | Plan |
|---|---|---|---|
/api/v1/addresses/{address}/bbr | Bygninger, enheder og grund for ejendommen, med BBR's egne felter | bbr | Data og Data + Tingbog |
/api/v1/addresses/{address}/estimate | Forventet pris med nedre og øvre grænse | estimate | Data og Data + Tingbog |
/api/v1/search | Sø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æf | search | Data og Data + Tingbog |
/api/v1/addresses/resolve | Fri 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/search | search | Data og Data + Tingbog |
/api/v1/companies | Virksomheder 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 data | companies | Data 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) | companies | Data og Data + Tingbog |
/api/v1/companies/{cvr}/properties | De 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) | companies | Data og Data + Tingbog |
/api/v1/properties/{bfe}/ownership-history | Ejerne af én ejendom gennem tiden, fra EJF: hvem, ejerandel, fra hvilken dato til hvilken. Selskaber på begge planer; personer med navn på Data + Tingbog | companies | Data og Data + Tingbog |
/api/v1/homes | Boliglisten: det fulde boligsøg med alle filtre og sorteringer (til salg, til leje, udbud, alle adresser); 30 boliger pr. side | homes | Data og Data + Tingbog |
/api/v1/addresses/{address}/comparables | De handler, skønnet bygger på: adresse, måned, pris, m², pris pr. m², afstand (nærmeste først, højst 50) | estimate | Data og Data + Tingbog |
/api/v1/addresses/{address}/plan-rules | Planernes bestemmelser for adressen, ordret (højst 200) | bbr | Data og Data + Tingbog |
/api/v1/areas/{area}/buyer-origin | Hvor 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øgn | bbr | Data og Data + Tingbog |
/api/v1/addresses/{address}/units | Alle enheder under indgangen (en etageejendoms lejligheder, et hus' ene enhed): pr. enhed dar_id, unit_id, unit_slug, slug, etage, dør, boligtype og areal | search | Data og Data + Tingbog |
/api/v1/addresses/{address}/listing-history | Annoncehistorikken 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) | estimate | Data og Data + Tingbog |
/api/v1/addresses/{address}/sales | Salgspriser 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 gang | estimate | Data og Data + Tingbog |
/api/v1/addresses/{address}/travel | Rejsen 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 straks | bbr | Data og Data + Tingbog |
/api/v1/addresses/{address}/land-registry | Hæftelser og lån, servitutter, kopidato, og købesum fra EJF | land_registry | Kun Data + Tingbog |
/api/v1/properties/{bfe}/land-registry | Det 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_unit | land_registry | Kun 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_registry | Kun Data + Tingbog |
/api/v1/usage | Nøglens forbrug denne måned | ingen | Data og Data + Tingbog |
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}.
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.
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.
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.
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.
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.
homes; en side uden boliger (efter den sidste, eller en søgning uden træffere) koster intet. pages er den sidste side, der findes (højst 5.000); indsnævr søgningen eller følg next_cursor for at nå længere: next_cursor står i hvert svar (tom, når der ikke er flere sider, og for en sortering uden markør), og sendes tilbage som after= sammen med de samme parametre og uden side. En markør er uigennemsigtig, gælder kun for den søgning og sortering den kom fra (ellers 400 invalid_request) og i syv dage; hver side er stadig ét opslag, og en markør-side bliver ikke dyrere, jo dybere man kommer (modsat side=N). I et after-svar er page og pages null; total er hele søgningens antal. Med format=csv kommer markøren i headeren X-Next-Cursor.429 rate_limited med detail.scope key_concurrency eller key og Retry-After i sekunder; det koster intet. Det er ud over grænsen pr. IP-adresse nedenfor.afvmax sammen med m=leje), er 400 invalid_request og tæller ikke; detail nævner parameteren. Et parameter-navn, vi ikke kender (fx postnr=2000 i stedet for omr=postnr:2000), er også 400 invalid_request (detail.code er unknown_parameter, og detail.did_you_mean giver det nærmeste navn, vi kender): vi gætter aldrig, og kaldet koster intet.id er annoncens id (entydigt pr. annonce: brug det til at fjerne dubletter i markederne salg, leje og udbud; med m=adr er rækken en adresse, ikke en annonce, og alle har id 0: brug address_slug); address_slug er adressens slug, som flere lejligheder i samme bygning deler; unit_slug er lejlighedens egen slug til /addresses/{address}, eller null, hvor annoncen ikke er knyttet til en lejlighedsside.De ti filtre, I oftest bruger. Flere værdier skrives med komma. Resten står i OpenAPI-filen.
| Parameter | Værdier | Betyder |
|---|---|---|
m | salg (standard), leje, udbud, adr | Markedet |
omr | postnr:2000 (eller blot 2000), kommune:<slug>, by:<navn>, bydel:<slug>, landsdel:<slug>, bbox:<vest,syd,øst,nord> | Området |
type | hus, raekkehus, lejlighed, fritid (sommerhus), andel, landejendom, grund, almen | Boligkategorien |
prismax | kroner (og prismin) | Højeste udbudspris; på m=adr højeste skønspris |
afvmax | heltal 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 |
arealmin | m² (og arealmax) | Mindste boligareal |
vaermin | antal (og vaermax) | Færrest værelser |
energifra | A til G (og energitil) | Bedste energimærke, der accepteres |
nedsat | 1 | Kun boliger, hvor udbudsprisen er sat ned, siden vi første gang så dem |
sort | ny (standard), prisop, prisned, kvm, liggetid, afv (mest under vores skøn), aabent, reno | Sorteringen; gyldige værdier afhænger af markedet |
side | 1, 2, 3 ... | Siden (30 boliger) |
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
Eksemplerne har rigtig form, men opdigtede adresser, id'er, CVR-numre og tal: feltnavnene er de rigtige. $GV_KEY er jeres nøgle.
Hent lejlighederne til salg. En side er 30 boliger og ét opslag:
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:
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:
Er unit_slug null, spørger I om bygningen med rækkens address_slug som {address}:
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.
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):
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.
/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.
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:
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.
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.
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.
| Felt | Type | Betyder |
|---|---|---|
id | integer | Vores 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_slug | string | ADRESSENS slug: send den som {address} til /addresses/{address}/... En bygnings lejligheder deler den; brug unit_slug for én lejlighed. |
unit_slug | string | Slug 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. |
address | string | Vej, husnummer, postnummer og by som én linje (en lejligheds etage og dør er ikke med). |
status | string | Annoncens tilstand, som vi gemmer den: for_sale, eller rented for en lejeannonce, der er oppe; adresse med m=adr. |
dwelling_type | string | BBR's boligtype, som annoncen oplyser den (Villa, Ejerlejlighed, Rækkehus ...), med registrets danske ord. |
villa_flat | integer | 1, hvor boligen er en villalejlighed (en lejlighed i et hus), ellers 0. |
price_dkk | integer | Udbudsprisen 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_dkk | integer | Udbudsprisen pr. kvadratmeter boligareal. |
price_withheld | boolean | True, hvor vi tilbageholder prisen efter adresseside-reglen (en pris, der dækker flere boliger, en andel); så er price_dkk null. |
price_change_pct | integer | Udbudsprisens seneste ændring i procent, med fortegn (en nedsættelse er negativ); null, hvor den ikke er ændret. |
days_on_market | integer | Antal dage, boligen har været udbudt (samme tal som på siden); null, hvor starten ikke kendes. |
area_m2 | integer | Boligareal i kvadratmeter (BBR, eller annoncens, hvor den oplyser et). |
rooms | integer | Antal værelser (BBR, eller annoncens, hvor den oplyser et). |
plot_m2 | integer | Grundareal i kvadratmeter. |
built_year | integer | Året, bygningen er opført (BBR). |
energy_label | string | Energimærke A til G (annoncens, ellers registrets for ejendommen). |
deviation_pct | integer | Udbudsprisen 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_range | boolean | True, hvor udbudsprisen ligger uden for vores skøns interval og ikke blot væk fra dets midte. |
estimate_note | string | Hvor 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. |
agent | string | Mæglerbutikkens navn; null, hvor annoncens navn kan høre til annoncens egen mægler som person (ingen person nævnes). |
url | string | Annoncen på mæglerens egen side. |
sale_form | string | Hvordan boligen sælges, hvor annoncen siger det (fx en buderunde), som annoncen skriver det. |
bid_deadline | string | Fristen for bud, DD.MM.ÅÅÅÅ. |
open_house | string | Næ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_mark | string | Hvor 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_note | string | Dagen, 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. |
balcony | boolean | Annoncen siger, at der er altan (true), eller intet er sagt (null). Aldrig false. |
lift | boolean | Annoncen siger, at der er elevator (true), eller intet er sagt (null). Aldrig false. |
pets_allowed | boolean | Annoncen siger, at husdyr er tilladt (true), eller intet er sagt (null). Aldrig false. |
deposit_dkk | integer | En lejeannoncens depositum i kroner. |
prepaid_rent_dkk | integer | En lejeannoncens forudbetalte leje i kroner. |
aconto_dkk | integer | En lejeannoncens månedlige acontobetaling for varme og vand, i kroner. |
available_from | string | En lejeannoncens ledighedsdato, som siden skriver den. |
available_now | boolean | En lejeannonce: boligen er ledig nu. |
dwellings_on_property | integer | Antal boliger på ejendommen (BBR); 0, hvor det ikke kendes. |
sea_view | integer | Klasse for havudsigt (vores terrænmodel): 1 til 3, null for ingen. |
lake_view | integer | Klasse for søudsigt (vores terrænmodel), null for ingen. |
noise_band | integer | Støjtrin for trafik 1 til 3 (Miljøstyrelsens kort), null for ingen. |
livestock_nearby | integer | En husdyrbedrift ligger nær boligen (vores afstandsberegning); null for ingen. |
preservation | integer | Bygningens fredningsstatus, 1 til 2; null, hvor der ingen er. |
soil_contamination_v1 | integer | Grunden er kortlagt som jordforurening V1 (registret); null, hvor den ikke er. |
soil_contamination_v2 | integer | Grunden er kortlagt som jordforurening V2 (registret); null, hvor den ikke er. |
vulnerable_area | integer | Boligen ligger i eller nær et område på regeringens liste over udsatte boligområder; null, hvor den ikke gør. |
oil_tank_grade | integer | Olietankens 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_note | string | Den ene sætning om ejendommens værste olietank, på engelsk (vores gradering af BBR's tankfelter); null, hvor der ingen er. |
oil_tank_level | string | Tankens bekymringsniveau som et ord: neutral, attention eller warning (sætningens alvor). |
renovated_value_dkk | integer | Vores skøn over boligens værdi efter renovering til normal standard, ud fra boligens stand (renoveringscaset). |
as_is_value_dkk | integer | Vores skøn over boligen, som den er (samme skøn, renovated_value_dkk er udledt af). |
renovation_building_weight | number | Bygningens andel af den offentlige vurdering, brugt af renoveringscaset. |
sales_text_condition | integer | Hvor slidt annoncens tekst siger, boligen er, fra -2 (trænger meget) til +2 (renoveret). |
text_themes | string | Temaer, salgsteksten nævner, som en kommasepareret liste af vores tema-id'er. |
condition_words | string | Mæglerens egne ord om stand fundet i teksten, kommaseparerede. |
agent_advert | string | Annoncens 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_advert | string | Annoncens egen formulering om flere boliger (fx "opdelt i to lejligheder"), uanset hvilke ord den rummer; null, hvor annoncens tekst ingen har. |
deviation_pct_unfiltered | integer | Vores 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_flag | string | Tilfæ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ø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.
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.
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.
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.
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.
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.
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 er JSON: error, message, detail.
400 invalid_request | En 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_cvr | CVR-nummeret i stien er ikke otte cifre. Tæller ikke |
401 invalid_key | Manglende eller ugyldig nøgle |
403 account_not_active | Kontoen er ikke aktiveret (afventer eller stoppet) |
404 unknown_address | Adressen findes ikke hos os (eller en enhed på den ligger i en bygning uden registreret indgang) |
404 no_property_for_address | Adressen kan ikke knyttes til én ejendom |
404 unknown_company | Intet selskab med det CVR-nummer. Tæller ikke |
404 unknown_endpoint | Stien findes ikke under /api/v1/ |
405 method_not_allowed | Stien findes, men svarer kun på GET |
429 monthly_cap_reached | Månedens grænse for kilden er nået |
429 rate_limited | For 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 unavailable | Tjenesten 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 |
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.
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.