Documents: Where are the files?

The documents linked to a property: zoning text, building case decisions and sales prospectuses, with signed download links instead of a manual lookup in the municipality's postal list.

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 in under a minute
• One GET call
• Signed download links
• Collected from several sources
• Updated continuously

info

Placepoint API is under development. This endpoint does not respond yet, and we have no date for when it will.

From property to documents

The call tells you where a property's actual files are, not just metadata saying that they exist. Brokers need sales prospectuses and decision documents gathered in one list when a new prospectus is put together, case officers need quick links to zoning attachments without searching the municipality's postal list, and property managers need one document archive per property in the portfolio without ordering each document separately from the municipality or Kartverket.

Each document comes with a type (building case decision, zoning text, sales prospectus and more), a title, a publication date and a media type, most often application/pdf. The downloadUrl field is a signed link, valid for 15 minutes from the moment the call returns it: fetch the list again for a fresh link when it expires, instead of storing the URL itself for later use.

The list gathers documents from several sources that otherwise each have their own archive. See Zoning Plans and utilisation and Building cases for the cases the documents belong to, and Housing coops and joint ownerships for who manages the property when the document concerns a share.

The same call exists for a company: annual reports, articles of association and other submitted documents by organisation number, with the same document format and the same signed links. That is the call you use when the question is about the owner rather than the property, together with Accounts for the figures and Companies for the company itself.

• Signed link, not just metadata

  downloadUrl is a valid download link for 15 minutes, not a reference you then have to look up yourself in the municipality's archive.

• Collected from several archives

  Building case decisions, zoning text and sales prospectuses come in the same list, instead of three or four separate lookups per property.

• Stable id for your own deduplication

  id is stable across calls, so a system can check whether a document has already been fetched before asking for a new signed link.

Fields that actually tell you something

One GET call with the matrikkel number gives you the whole document list. The fields below are the ones that decide what you can use the response for straight away.

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.

The call requires the same scope, property:read, as the rest of the property resources, so a client with access to the other property calls needs no separate permission just for the document list.

Documents for a company

Same response format, but by organisation number and with the 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 in under a minute

1. Log in with GitHub

   One click, under a minute, no payment card. The key comes back to this page.

2. Call the endpoint

   The curl above fills in with your key once you are logged in. The call only needs the country code and matrikkel number, which you already have from the property lookup.

3. Use the response

   Fetch downloadUrl as soon as you need the document, and ask for the list again if the link has expired.

Data and sources

The documents are compiled from municipal case archives, Kartverket's zoning data and submitted sales prospectuses, updated continuously as new documentation is published.

See also

• Property panel
• Land register and documents
• Case access
• Technical reference: property documents
• Technical reference: company documents
• Placepoint API

Questions and answers

How long does a download link last?

15 minutes from the moment the call returns it. The short lifetime is deliberate: a link that leaks out of the system it was fetched in stops working by itself within a short time. Fetch the list again for a fresh link.

How current is the data?

The documents are compiled from municipal case archives, Kartverket's zoning data and submitted sales prospectuses, updated continuously as new documentation is published.

Which document types are included?

Building case decisions, zoning text and sales prospectuses are the core for the property, annual reports and articles of association for the company, and more types will follow as municipal archives are connected. kind tells you which type each document is.

Do I need a separate scope for the documents?

No. The call uses the same property:read as the rest of the property resources, so a client with access to the other property calls needs no extra permission.

Find the documents for a property

One GET call gives you zoning text, building case decisions and sales prospectuses together, with signed download links. Log in with GitHub at the top of the page to try it today, or get in touch for access to the whole country.

Logg inn med GitHub