Dokument: Kvar ligg filene?

Dokumenta knytte til ein eigedom: reguleringstekst, byggjesaksvedtak og salsoppgåver, med signerte nedlastingslenker i staden for eit manuelt oppslag i postlista til kommunen.

Logg inn med GitHubSlik ser det ut ↓Teknisk referanse →

Nøkkelen virker på Placepoint API og på dagens Data API, 35 kall om dagen i 14 dager.

Prøv med et ekte bygg: Tordenskiolds gate 2

• Test på under eitt minutt
• Eitt GET-kall
• Signerte nedlastingslenker
• Samla frå fleire kjelder
• Oppdatert løpande

info

Placepoint API er under utvikling. Dette endepunktet svarar ikkje enno, og vi har ingen dato for når det gjer det.

Frå eigedom til dokument

Kallet svarar på kvar dei faktiske filene til ein eigedom ligg, ikkje berre metadata om at dei finst. Meklarar treng salsoppgåver og vedtaksdokument samla i éi liste når eit nytt prospekt blir sett saman, sakshandsamarar treng raske lenker til reguleringsvedlegg utan å leite i postlista til kommunen, og forvaltarar treng eitt dokumentarkiv per eigedom i porteføljen utan å tinge kvart dokument enkeltvis frå kommune eller Kartverket.

Kvart dokument kjem med type (byggjesaksvedtak, reguleringstekst, salsoppgåve og fleire), tittel, publiseringsdato og medietype, oftast application/pdf. Feltet downloadUrl er ei signert lenke, gyldig i 15 minutt frå kallet returnerer henne: hent lista på nytt for ei fersk lenke når ho går ut, i staden for å lagre sjølve URL-en til seinare bruk.

Lista samlar dokument frå fleire kjelder som elles har kvart sitt arkiv. Sjå Reguleringsplanar og utnytting og Byggjesaker for sjølve sakene dokumenta høyrer til, og Burettslag og sameige for kven som forvaltar eigedommen når dokumentet gjeld ein andel.

Det same kallet finst for eit selskap: årsrapportar, vedtekter og andre innsende dokument på organisasjonsnummer, med same dokumentformat og same signerte lenker. Det er kallet du brukar når spørsmålet handlar om eigaren i staden for eigedommen, saman med Rekneskap for tala og Selskap for selskapet sjølv.

• Signert lenke, ikkje berre metadata

  downloadUrl er ei gyldig nedlastingslenke i 15 minutt, ikkje ein referanse du sjølv må slå opp vidare i arkivet til kommunen.

• Samla frå fleire arkiv

  Byggjesaksvedtak, reguleringstekst og salsoppgåver kjem i same lista, i staden for tre eller fire separate oppslag per eigedom.

• Stabil id for eigen dedupe

  id er stabil på tvers av kall, så eit system kan sjekke om eit dokument alt er henta før det ber om ei ny signert lenke.

Felt som faktisk seier noko

Eitt GET-kall med matrikkelnummeret gir heile dokumentlista. Felta under er dei som avgjer kva du kan bruke svaret til med det same.

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

curl -X GET "https://data.placepoint.no/properties/NO/0301-209-369-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: property: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 krev same scope, property:read, som resten av eigedomsressursane, så ein klient med tilgang til dei andre eigedomskalla treng ikkje noko eige løyve berre for dokumentlista.

Dokument på eit selskap

Same svarformat, men på organisasjonsnummer og med scope company:read.

GET/companies/{country}/{id}/documents

curl -X GET "https://data.placepoint.no/companies/NO/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: company: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.

Test på under eitt minutt

1. Logg inn med GitHub

   Eitt klikk, under eitt minutt, ingen betalingskort. Nøkkelen kjem tilbake til denne sida.

2. Kall endepunktet

   Curl-en over fyller seg ut med nøkkelen din når du er logga inn. Kallet treng berre landkode og matrikkelnummer, det du alt har frå eigedomsoppslaget.

3. Bruk svaret

   Hent downloadUrl med ein gong du treng dokumentet, og be om lista på nytt om lenka har gått ut.

Data og kjelder

Dokumenta er sette saman frå kommunale saksarkiv, reguleringsdata frå Kartverket og innsende salsoppgåver, oppdatert løpande etter kvart som ny dokumentasjon blir publisert.

Sjå også

• Eigedomspanel
• Grunnbok og dokument
• Saksinnsyn
• Teknisk referanse: eigedomsdokument
• Teknisk referanse: selskapsdokument
• Placepoint API

Spørsmål og svar

Kor lenge varer ei nedlastingslenke?

15 minutt frå kallet returnerer henne. Den korte levetida er medviten: ei lenke som lekk ut av systemet ho blei henta i, sluttar sjølv å verke i løpet av kort tid. Hent lista på nytt for ei fersk lenke.

Kor ferske er dataa?

Dokumenta er sette saman frå kommunale saksarkiv, reguleringsdata frå Kartverket og innsende salsoppgåver, oppdatert løpande etter kvart som ny dokumentasjon blir publisert.

Kva dokumenttypar er med?

Byggjesaksvedtak, reguleringstekst og salsoppgåver er kjernen på eigedommen, årsrapportar og vedtekter på selskapet, og fleire typar kjem etter kvart som kommunale arkiv blir kopla på. kind seier kva type kvart dokument er.

Treng eg eit eige scope for dokumenta?

Nei. Kallet brukar same property:read som resten av eigedomsressursane, så ein klient med tilgang til dei andre eigedomskalla treng ikkje noko ekstra løyve.

Finn dokumenta til ein eigedom

Eitt GET-kall gir reguleringstekst, byggjesaksvedtak og salsoppgåver samla, med signerte nedlastingslenker. Logg inn med GitHub øvst på sida for å prøve det i dag, eller ta kontakt for tilgang til heile landet.

Logg inn med GitHub