Om tjenesten
API for dokumentbestilling kan benyttes av norske offentlige og private virksomheter som har behov for å bestille attesterte kopier av tinglyste dokumenter og bekreftede grunnboksutskrifter for fast eiendom og borettslagsandel.
APIet leverer bestilt dokument digitalt tilbake.
Funksjoner
APIet lar deg bestille både tinglyste dokumenter og grunnboksutskrifter ved å sende en forespørsel til APIet. Når en bestilling er opprettet, vil du motta en bestillingsId, som kan brukes til å laste ned dokumentet fra endepunktet v1/bestilling/{bestillingId}.
Tinglyste dokumenter
For tinglyste dokumenter må forespørselen inneholde informasjon om hvilket dokument som ønskes, og dokumentet blir tilgjengelig for nedlasting etter godkjenning fra Kartverket. Denne nedlastingslenken er gyldig i 3 måneder, og vi anbefaler at dokumentet lastes ned eller lagres på en annen måte, ettersom en ny bestilling vil kreve en ny gebyrberegning.
Grunnboksutskrifter
Grunnboksutskrifter krever ingen behandling hos Kartverket og vil alltid ha status Godkjent umiddelbart etter bestilling. Disse kan også hentes fra v1/bestilling/{bestillingId} og har ingen utløpstid.
Nedlasting av dokumenter
Det er mulig å hente dokument og følgebrev hver for seg, og de relevante query-parametrene er beskrevet i
Swagger-dokumentasjonen. Dersom ingen spesifikasjon oppgis, returnerer APIet både dokument og følgebrev i samme fil. Hvis de hentes separat, er det viktig å formidle begge filene til sluttbruker, slik at all nødvendig informasjon om bestillingen blir tilgjengelig.Statuser for bestillinger
| Status | Hva betyr det? |
|---|---|
| Godkjent | Bestillingen er enten blitt manuelt eller automatisk godkjent av Kartverket og dokumentet kan nå hentes ut. |
| Klar for behandling | Bestillingen er mottatt hos Kartverket, og venter på behandling. |
| Under behandling | Bestillingen er mottatt hos Kartverket, og behandling er påbegynt. Behandlingstid er 1 virkedag, men som oftest raskere. |
| Avvist | Bestillingen er behandlet av Kartverket, men dokumentet kan ikke gis ut. Bestillingen blir kansellert og ikke fakturert. |
Begrensninger
APIet har følgende begrensninger:
- Kun tilgjengelig for kunder som er registrert hos Digdir og har fått tilgang til APIet
- Krever et gyldig maskinporten-token som har begrenset varighet og må fornyes regelmessig for å opprettholde tilgangen til APIet
- Gir tilgang til alle tinglyste dokumenter som er tilgjengelige digitalt og bekreftede grunnboksutskrifter
Miljøer
Tjenesten er tilgjengelig i følgende miljøer. Les mer om Testmiljøer.
Testmiljø:
https://dokumentbestilling-test.kartverket.no/Produksjonsmiljø:
https://dokumentbestilling.kartverket.no/