Hvor ligger filene?

Dokumentene knyttet til en eiendom: reguleringstekst, byggesaksvedtak og salgsoppgaver, med signerte nedlastingslenker i stedet for et manuelt oppslag i kommunens postliste.

Logg inn med GitHubSlik ser det ut ↓Teknisk referanse →

Nøkkelen virker i dag på Leietaker-API og dagens Data API; Placepoint API godtar samme nøkkel når det lanseres.

Prøv med et ekte bygg: Oslo S, Jernbanetorget 1

• Prøvenøkkel med GitHub på under ett minutt
• Ett GET-kall
• Signerte nedlastingslenker
• Samlet fra flere kilder
• Oppdatert løpende

ℹ️ Endepunktet svarer når Placepoint API er lansert. Kontrakten under er endelig; Leietaker-API svarer allerede.

Fra eiendom til dokumenter

Kallet svarer på hvor de faktiske filene til en eiendom ligger, ikke bare metadata om at de finnes. Meglere trenger salgsoppgaver og vedtaksdokumenter samlet i én liste når et nytt prospekt settes sammen, saksbehandlere trenger raske lenker til reguleringsvedlegg uten å lete i kommunens postliste, og forvaltere trenger ett dokumentarkiv per eiendom i porteføljen uten å bestille hvert dokument enkeltvis fra kommune eller Kartverket.

Hvert dokument kommer med type (byggesaksvedtak, reguleringstekst, salgsoppgave og flere), tittel, publiseringsdato og medietype, som oftest application/pdf. Feltet downloadUrl er en signert lenke, gyldig i 15 minutter fra kallet returnerer den: hent listen på nytt for en fersk lenke når den utløper, i stedet for å lagre selve URL-en for senere bruk.

Listen samler dokumenter fra flere kilder som ellers har hvert sitt arkiv. Se Reguleringsplaner og utnyttelse og Byggesaker for selve sakene dokumentene hører til, og Borettslag og sameier for hvem som forvalter eiendommen når dokumentet gjelder en andel.

Det samme kallet finnes for et selskap: årsrapporter, vedtekter og andre innsendte dokumenter på organisasjonsnummer, med samme dokumentformat og samme signerte lenker. Det er kallet du bruker når spørsmålet handler om eieren i stedet for eiendommen, sammen med Regnskap for tallene og Selskaper for selskapet selv.

• Signert lenke, ikke bare metadata

  downloadUrl er en gyldig nedlastingslenke i 15 minutter, ikke en referanse du selv må slå opp videre i kommunens arkiv.

• Samlet fra flere arkiv

  Byggesaksvedtak, reguleringstekst og salgsoppgaver kommer i samme liste, i stedet for tre eller fire separate oppslag per eiendom.

• Stabil id for egen dedupe

  id er stabilt på tvers av kall, så et system kan sjekke om et dokument allerede er hentet før det ber om en ny signert lenke.

Felter som faktisk sier noe

Ett GET-kall med matrikkelnummeret gir hele dokumentlisten. Feltene under er de som avgjør hva du kan bruke svaret til med det samme.

GET/properties/{country}/{cadastreId}/documents

curl -X GET "https://data.placepoint.no/properties/NO/0301-207-76-0-0/documents" \
  -H "Authorization: Bearer $TOKEN"

svar · 200

{
  "items": [
    {
      "id": "doc_77213",
      "kind": "SALES_PROSPECTUS",
      "title": "Salgsoppgave DEG 16 H0301",
      "publishedDate": "2015-09-01",
      "downloadUrl": "https://data.placepoint.no/files/doc_77213?sig=ab12cd34ef56&exp=1893456000",
      "mediaType": "application/pdf"
    }
  ]
}

Scope: properties.readTeknisk referanse og Try-it

Vis alle felt (6)

Felt	Type	Beskrivelse
items[].id	string	Document identifier.
items[].kind	string	Document category. The set grows as new archives are connected; treat an unknown value as OTHER.
items[].title	string	Document title.
items[].publishedDate	string	When the document was published.
items[].downloadUrl	string	Signed download URL, valid for 15 minutes.
items[].mediaType	string	IANA media type, e.g. application/pdf.

Kallet krever samme scope, properties.read, som resten av eiendomsressursene, så en klient med tilgang til de andre eiendomskallene trenger ingen egen tillatelse bare for dokumentlisten.

Dokumenter på et selskap

Samme svarformat, men på organisasjonsnummer og med scope companies.read.

GET/companies/{scheme}/{id}/documents

curl -X GET "https://data.placepoint.no/companies/0192/987654321/documents" \
  -H "Authorization: Bearer $TOKEN"

svar · 200

{
  "items": [
    {
      "id": "doc_91044",
      "kind": "ANNUAL_REPORT",
      "title": "Årsrapport 2025 Entra ASA",
      "publishedDate": "2026-04-24",
      "downloadUrl": "https://data.placepoint.no/files/doc_91044?sig=cd34ef56ab12&exp=1893456000",
      "mediaType": "application/pdf"
    }
  ]
}

Scope: companies.readTeknisk referanse og Try-it

Vis alle felt (6)

Felt	Type	Beskrivelse
items[].id	string	Document identifier.
items[].kind	string	Document category. The set grows as new archives are connected; treat an unknown value as OTHER.
items[].title	string	Document title.
items[].publishedDate	string	When the document was published.
items[].downloadUrl	string	Signed download URL, valid for 15 minutes.
items[].mediaType	string	IANA media type, e.g. application/pdf.

Tre steg til første svar

1. Logg inn med GitHub

   Ett klikk, under ett minutt, ingen betalingskort. Nøkkelen kommer tilbake til denne siden.

2. Kall endepunktet

   Curl-en over fyller seg ut med nøkkelen din når du er logget inn. Kallet trenger bare landkode og matrikkelnummer, det du allerede har fra eiendomsoppslaget.

3. Bruk svaret

   Hent downloadUrl med en gang du trenger dokumentet, og be om listen på nytt hvis lenken har utløpt.

Data og kilder

Dokumentene er sammenstilt fra kommunale saksarkiver, Kartverkets reguleringsdata og innsendte salgsoppgaver, oppdatert løpende etter hvert som ny dokumentasjon publiseres.

Se også

• Eiendomspanel
• Teknisk referanse: eiendomsdokumenter
• Teknisk referanse: selskapsdokumenter
• Placepoint API

Spørsmål og svar

Hvor lenge varer en nedlastingslenke?

15 minutter fra kallet returnerer den. Den korte levetiden er bevisst: en lenke som lekker ut av systemet den ble hentet i, slutter selv å virke i løpet av kort tid. Hent listen på nytt for en fersk lenke.

Hvor ferske er dataene?

Dokumentene er sammenstilt fra kommunale saksarkiver, Kartverkets reguleringsdata og innsendte salgsoppgaver, oppdatert løpende etter hvert som ny dokumentasjon publiseres.

Hvilke dokumenttyper er med?

Byggesaksvedtak, reguleringstekst og salgsoppgaver er kjernen på eiendommen, årsrapporter og vedtekter på selskapet, og flere typer kommer etter hvert som kommunale arkiver kobles på. kind sier hvilken type hvert dokument er.

Trenger jeg et eget scope for dokumentene?

Nei. Kallet bruker samme properties.read som resten av eiendomsressursene, så en klient med tilgang til de andre eiendomskallene trenger ingen ekstra tillatelse.

Finn dokumentene til en eiendom

Ett GET-kall gir reguleringstekst, byggesaksvedtak og salgsoppgaver samlet, med signerte nedlastingslenker. Logg inn med GitHub øverst på siden for å prøve det i dag, eller ta kontakt for tilgang til hele landet.

Logg inn med GitHub