Var ligger filerna?

Dokumenten som är kopplade till en fastighet: planbestämmelsetext, bygglovsbeslut och försäljningsprospekt, med signerade nedladdningslänkar i stället för en manuell sökning i kommunens postlista.

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

• Provnyckel med GitHub på under en minut
• Ett GET-anrop
• Signerade nedladdningslänkar
• Samlat från flera källor
• Uppdaterad löpande

ℹ️ Slutpunkten svarar när Placepoint API är lanserat. Kontraktet nedan är slutgiltigt, Hyresgäst-API svarar redan.

Från fastighet till dokument

Anropet svarar på var de faktiska filerna till en fastighet ligger, inte bara metadata om att de finns. Mäklare behöver försäljningsprospekt och beslutsdokument samlade i en lista när ett nytt prospekt sätts samman, handläggare behöver snabba länkar till planbilagor utan att leta i kommunens postlista, och förvaltare behöver ett dokumentarkiv per fastighet i portföljen utan att beställa varje dokument separat från kommun eller Kartverket.

Varje dokument kommer med typ (bygglovsbeslut, planbestämmelsetext, försäljningsprospekt och fler), titel, publiceringsdatum och medietyp, oftast application/pdf. Fältet downloadUrl är en signerad länk, giltig i 15 minuter från att anropet returnerar den: hämta listan på nytt för en färsk länk när den löper ut, i stället för att spara själva URL:en för senare bruk.

Listan samlar dokument från flera källor som annars har sina egna arkiv. Se Detaljplaner och utnyttjande och Bygglovsärenden för själva ärendena som dokumenten hör till, och Bostadsrättsföreningar och samfälligheter för vem som förvaltar fastigheten när dokumentet gäller en andel.

Samma anrop finns för ett bolag: årsredovisningar, stadgar och andra inskickade dokument på organisationsnummer, med samma dokumentformat och samma signerade länkar. Det är anropet du använder när frågan handlar om ägaren i stället för fastigheten, tillsammans med Bokslut för siffrorna och Företag för bolaget självt.

• Signerad länk, inte bara metadata

  downloadUrl är en giltig nedladdningslänk i 15 minuter, inte en referens du själv måste söka vidare på i kommunens arkiv.

• Samlat från flera arkiv

  Bygglovsbeslut, planbestämmelsetext och försäljningsprospekt kommer i samma lista, i stället för tre eller fyra separata sökningar per fastighet.

• Stabilt id för egen dedupe

  id är stabilt fördelat på anrop, så ett system kan kontrollera om ett dokument redan är hämtat innan det ber om en ny signerad länk.

Fält som faktiskt säger något

Ett GET-anrop med matrikkelnummeret ger hela dokumentlistan. Fälten nedan är de som avgör vad du kan använda svaret till direkt.

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.

Anropet kräver samma scope, properties.read, som resten av fastighetsresurserna, så en klient med åtkomst till de andra fastighetsanropen behöver ingen egen behörighet bara för dokumentlistan.

Dokument på ett bolag

Samma svarsformat, men på organisationsnummer och 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 till första svaret

1. Logga in med GitHub

   Ett klick, under en minut, inget betalkort. Nyckeln kommer tillbaka till den här sidan.

2. Anropa slutpunkten

   Curl-anropet ovan fylls ut med din nyckel när du är inloggad. Anropet behöver bara landskod och matrikkelnummer, det du redan har från fastighetssökningen.

3. Använd svaret

   Hämta downloadUrl så snart du behöver dokumentet, och begär listan på nytt om länken har löpt ut.

Data och källor

Dokumenten är sammanställda från kommunala ärendearkiv, Kartverkets plandata och inskickade försäljningsprospekt, uppdaterade löpande i takt med att ny dokumentation publiceras.

Se även

• Fastighetspanel
• Teknisk referens: fastighetsdokument
• Teknisk referens: bolagsdokument
• Placepoint API

Frågor och svar

Hur länge gäller en nedladdningslänk?

15 minuter från att anropet returnerar den. Den korta livslängden är medveten: en länk som läcker ut ur systemet den hämtades i slutar själv att fungera inom kort tid. Hämta listan på nytt för en färsk länk.

Hur färska är uppgifterna?

Dokumenten är sammanställda från kommunala ärendearkiv, Kartverkets plandata och inskickade försäljningsprospekt, uppdaterade löpande i takt med att ny dokumentation publiceras.

Vilka dokumenttyper ingår?

Bygglovsbeslut, planbestämmelsetext och försäljningsprospekt är kärnan på fastigheten, årsredovisningar och stadgar på bolaget, och fler typer kommer i takt med att kommunala arkiv kopplas på. kind säger vilken typ varje dokument är.

Behöver jag ett eget scope för dokumenten?

Nej. Anropet använder samma properties.read som resten av fastighetsresurserna, så en klient med åtkomst till de andra fastighetsanropen behöver ingen extra behörighet.

Hitta dokumenten till en fastighet

Ett GET-anrop ger planbestämmelsetext, bygglovsbeslut och försäljningsprospekt samlade, med signerade nedladdningslänkar. Logga in med GitHub högst upp på sidan för att prova det i dag, eller ta kontakt för åtkomst till hela landet.

Logg inn med GitHub