TypeScript-SDK-reference

import { GrundfastClient, GrundfastError } from '@grundfast/sdk';

// gf_test_… i CI/staging (sandbox, faktureres aldrig), gf_live_… i produktion.
const gf = new GrundfastClient({ apiKey: 'gf_live_…' });
// Valgfrit: baseUrl (default https://api.grundfast.dk) og en injiceret fetch.

try {
  const ejendom = await gf.ejendom(999999999);
} catch (err) {
  if (err instanceof GrundfastError) {
    console.error(err.status, err.message); // fx 404 "property not found"
  }
}

const gf = new GrundfastClient();

await gf.demoEjendom();             // EjendomRollup
await gf.demoEjendomGeoJson();      // BbrFeatureCollection
await gf.demoMatrikel();            // MatrikelEjendom
await gf.demoJordstykke();          // JordstykkeResult
await gf.demoDagi();                // DagiOmraade
await gf.demoDhm();                 // DhmPunkt
await gf.demoStednavne();           // StednavnePunkt
await gf.demoAdresse();             // AdresseResponse
await gf.demoAdresseSearch();       // AdresseSearchResponse
await gf.demoCvr();                 // CvrResponse
await gf.demoGeodanmarkBygninger(); // GeodanmarkBygninger
await gf.demoJord();                // JordOmraadeklassificering
await gf.demoNatur();               // NaturSkovbyggelinje
await gf.dagiTemaer();              // DagiIndex (offentligt discovery-index)
await gf.statsKommuner();           // KommuneStats (offentligt — per-kommune dækning)
await gf.kodeliste('varmeinstallation'); // KodelisteResponse

const ejendom = await gf.ejendom(5651067);        // EjendomRollup
const geojson = await gf.ejendomGeoJson(5651067); // BbrFeatureCollection
const bygning = await gf.bygning(5651067);        // EjendomRollup (samme join)

// Op til 50 BFE i ét kald — partial-failure pr. BFE:
const { results, errors } = await gf.ejendomBatch([5651067, 12345678]);

// Auto-paginér en vilkårligt stor BFE-liste i 50-chunks:
for await (const item of gf.ejendomStream(mineBfeer)) {
  console.log(item.bfe, item.ejendom.antal_bygninger, item.stale);
}

const matrikel = await gf.matrikel(5651067);              // MatrikelEjendom
const batch = await gf.matrikelBatch([5651067, 12345678]); // MatrikelBatchResponse

// Point-in-time: posten som registreret på en dato.
const ejendomDa = await gf.ejendom(5651067, '2020-01-01');        // EjendomRollup
const matrikelDa = await gf.matrikel(5651067, new Date('2020-01-01')); // MatrikelEjendom
const adresseDa = await gf.adresse('0a3f50a0-…', '2020-01-01');   // AdresseResponse

// Versionstidslinjer (nyeste først):
const bbrHist = await gf.ejendomHistorik(5651067);      // BbrHistorikResponse (pr. bygning)
const matHist = await gf.matrikelHistorik(5651067);     // MatrikelHistorikResponse (pr. jordstykke)
const adrHist = await gf.adresseHistorik('0a3f50a0-…'); // AdresseHistorikResponse

const fp = await gf.geodanmarkBygninger(5651067); // GeodanmarkBygninger
fp.buildings.forEach((b) => console.log(b.bbr_uuid, b.rings));
console.log(fp.attribution); // "@geodanmark" — CC BY 4.0-kreditering

const parcel = await gf.jordstykkeReverse(10.32, 56.16); // JordstykkeResult (+ bfe_nummer)
const byKey = await gf.jordstykke(60851, '4a');          // JordstykkeResult (ejerlavskode + matrikelnr)

const temaer = await gf.dagiTemaer();            // DagiIndex (uden nøgle)
const liste = await gf.dagiList('kommune');      // DagiList
const omraade = await gf.dagi('kommune', 851);   // DagiOmraade
const batch = await gf.dagiBatch('kommune', [851, 101]); // DagiBatchResponse

const kote = await gf.dhm(10.32, 56.16);               // DhmPunkt (terraen_m / overflade_m)

// Højden på HVER bygning på ejendommen i ét kald — målt inde i fodaftrykket, ikke
// i et punkt ved siden af huset. Alle koter er DVR90.
const h = await gf.dhmBygninger(5651067);              // DhmBygningshoejder
h.bygninger[0]?.hoejde_m;      // 6.2 | null  — tag_m − terraen_m, aldrig 0 for "ukendt"
h.bygninger[0]?.hoejde_maalt;  // false ⇒ hoejde_m er null, og aarsag siger hvorfor
h.metode;                      // { tag: 'p95', terraen: 'median', hoejde: 'tag_m - terraen_m' }

const steder = await gf.stednavne(10.32, 56.16, 1000); // StednavnePunkt (radius i meter)

const jord = await gf.jordOmraadeklassificering(10.1763672, 56.1327761);
jord.omraadeklassificeret; // boolean — § 50 a dækker punktet
jord.analysefri;           // true | false | null (null = ikke omfattet)

const natur = await gf.naturSkovbyggelinje(8.5286062, 55.8988908);
natur.skovbyggelinje;      // boolean — en GÆLDENDE § 17-linje dækker punktet
natur.ophaevet;            // et selvstændigt spørgsmål — begge kan være true
natur.ophaevede;           // de ophævede polygoner: årsag + kommunens afgørelse
natur.usikker;             // true = intet VEDTAGET grundlag bag det ja — bekræft hos kommunen

const svar = await gf.naturByggelinjer(15.1450245, 55.1385081);

svar.antal_i_kraft;   // hvor mange linjer der gælder her
svar.utilgaengelige;  // [] = alle ti blev faktisk besvaret

const strand = svar.linjer.strandbeskyttelse;
strand.status;        // 'ok' | 'utilgaengelig' — læs ALTID denne først
strand.inden_for;     // boolean | null (null KUN når status !== 'ok')
strand.usikker;       // kvalificerer et ja, aldrig et nej
strand.afstand_m;     // fortegnet: -1.5 = 1,5 m INDE, +11.8 = 11,8 m ude
strand.hjemmel;       // 'naturbeskyttelsesloven § 15'

// Ophævede linjer følger med som dokumentation — en ophævet linje og
// ingen linje ser ens ud i en boolean, men ikke ved kommunens skrivebord.
svar.linjer.soe.ophaevede;

const adr = await gf.adresse('0a3f50a0-…');               // AdresseResponse (UUID-opslag)
const hits = await gf.adresseSearch('rådhusplads', 8);   // AdresseSearchResponse
const abatch = await gf.adresseBatch(['uuid-1', 'uuid-2']); // AdresseBatchResponse
const rev = await gf.adgangsadresseReverse(10.32, 56.16, { radius: 200, perSide: 1 }); // AdgangsadresseReverse
const byBfe = await gf.adgangsadresserByBfe(5651067);    // AdgangsadresserByBfe
const vask = await gf.datavask('rådhuspladsen 1 kbh');   // DatavaskResultat (A/B/C-bånd)

const ejerlav = await gf.ejerlav(100, 1);             // EjerlavList (per_side, side)
const etEjerlav = await gf.ejerlavByKode(60851);      // EjerlavOpslag
const ejerlavAuto = await gf.ejerlavAutocomplete('vejle'); // EjerlavList

const post = await gf.postnumre();                    // PostnummerList
const etPost = await gf.postnummer('8000');           // PostnummerRef & { meta }
const postAuto = await gf.postnummerAutocomplete('80'); // PostnummerList

const veje = await gf.vejnavne(100, 1);               // VejnavnList
const vejAuto = await gf.vejnavnAutocomplete('rådhus'); // VejnavnList

const auto = await gf.autocomplete('rådhus', 'vejnavn'); // AutocompleteResponse

const virksomhed = await gf.cvr('37527968'); // CvrResponse

const job = await gf.createExport({ register: 'bbr', format: 'csv', bfe: [5651067, 12345678] });
const status = await gf.getExport(job.id);   // ExportJob — poll til status === 'completed'
const jobs = await gf.listExports();         // ExportJob[]
const file = await gf.downloadExport(job.id); // string (CSV/NDJSON/GeoJSON)