Begreb Kald, kvoter og nøgler · Grundfast

# Kald

Et kald er den enhed, Grundfast måler forbrug i: ét opslag mod API’et, der lykkes, er ét kald. Planernes kvoter og prisen for overforbrug er angivet i kald.

Også kaldt: API-kald, Opslag, Forespørgsel

## Hvad der tæller

Et opslag, der svarer `2xx`, tæller som ét kald — uanset register, og uanset om svaret kom fra cachen eller direkte fra kilden. Et opslag på [`/v1/bbr/ejendom/:bfe`](https://grundfast.dk/docs/api/bbr-ejendom) er ét kald, også selvom svaret samler grund, bygninger, enheder og adresser, som det ville kræve mange forespørgsler at hente hos kilden.

- **Batch tæller pr. id.** Et `:batch`-kald med 40 BFE-numre er 40 kald. Dubletter tælles én gang, og id’er, der ikke kunne slås op, afregnes ikke.
- **Eksport tæller pr. id.** Id’er, der ikke kunne hentes, krediteres tilbage.
- **Højdeprofiler tæller pr. punkt.** [`/v1/dhm/profil`](https://grundfast.dk/docs/api/dhm-profil) er ét kald pr. punkt i profilen; [`/v1/dhm/terraen`](https://grundfast.dk/docs/api/dhm-terraen) er ét kald for hele nettet.
- **MCP tæller som REST.** Et værktøjskald fra en AI-agent, der lykkes, er ét kald. Opstart, værktøjsliste og fejlede værktøjskald er gratis.

## Hvad der ikke koster noget

Fejl hos os eller hos kilden — `5xx` og timeout — lægges tilbage i kvoten og afregnes aldrig. Klientfejl (`4xx`, fx et BFE-nummer, der ikke findes) afregnes heller ikke, men tæller med i kvotetælleren. De nøglefri demo-endpoints, som dokumentationen bruger, tæller ikke mod nogen plan, og kald med en [testnøgle](https://grundfast.dk/begreber/testnoegle) faktureres aldrig.

## Det skal du vide som udvikler

- **Ét kald er ikke ét register.** Ét samlet ejendomsopslag er billigere end at slå bygninger, jordstykker og adresser op hver for sig — vælg det endpoint, der svarer på hele spørgsmålet.
- **Cache selv det, der ikke ændrer sig.** Kodelister, postnumre og kommuner ændrer sig sjældent; hent dem én gang og gem dem.
- **Følg forbruget i headerne.** `X-Quota-Remaining` står på hvert svar, så du kan se, hvor mange kald der er tilbage af [månedskvoten](https://grundfast.dk/begreber/maanedskvote).

Skal du regne et budget, så tæl de opslag, din integration laver pr. bruger eller pr. sag, og gang med det forventede antal om måneden. Beregneren på [/priser](https://grundfast.dk/priser) bruger samme regnestykke som fakturaen.

## I API’et

- [Hvad der tæller som et kald](https://grundfast.dk/docs/rate-limits)
- [Batch og eksport pr. id](https://grundfast.dk/docs/batch-og-eksport)
- [Fejl, der lægges tilbage i kvoten](https://grundfast.dk/docs/fejl)

## Slå det op på en rigtig ejendom

Med en gratis nøgle får du begrebet som felt i svaret — oversat, med WGS84-geometri og på tværs af registrene med samme BFE-nummer.

[Kom i gang gratis](https://grundfast.dk/dashboard?mode=register) [Alle begreber](https://grundfast.dk/begreber)

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0

Relaterede begreber

- [Månedskvote Månedskvoten er det antal kald, en plan indeholder pr. kalendermåned. Den nulstilles den 1. i måneden kl. 00:00 UTC, og forbrug over den afregnes som overforbrug på de betalte planer.](https://grundfast.dk/begreber/maanedskvote)
- [Testnøgle En testnøgle er en API-nøgle, der begynder med gf_test_. Den rammer de samme rigtige registre som en live-nøgle (gf_live_), men faktureres aldrig og tæller ikke mod planens kvote.](https://grundfast.dk/begreber/testnoegle)
- [BFE-nummer BFE-nummeret er det nummer, en Bestemt Fast Ejendom har i de danske ejendomsregistre. Det er den fælles nøgle, der binder grunden i Matriklen, bygningerne i BBR, vurderingen og ejerskabet sammen.](https://grundfast.dk/begreber/bfe-nummer)