Get location history of companies by organization number, batch, and/or update date

GET 
/companies/location-history

Location History By Query Endpoint

Overview

Returns location intervals from occupancy_intervals, optionally filterable by organization-number, batch-id, and/or an updated-start-date/updated-end-date range — any combination of the three can be used together (combined filters are ANDed together), and omitting all three simply paginates over the entire collection. Results are sorted newest first, same as the single-organization location-history endpoint, but since a request is not restricted to one organization, each interval carries its own orgNr.

The response is paginated: page (default 1) and page-size (default 1000) control which slice of the matching intervals is returned, and totalPages in the response tells you how many pages exist in total. Requesting a page beyond totalPages returns 404, same as any other filter combination with no matches.

Each interval represents a period during which a company's forretningsadresse matched a given address or property. A currently-open interval (if any) will have validTo as null.

Returns 404 if no intervals are found for the given filters.

Data is sourced from the occupancy_intervals collection in the PropCloud Leads database, which is built from Enhetsregisteret address change events.

Example Requests

curl -X 'GET' \
  'https://apis.propcloud.no/api/public/companies/location-history' \
  -H 'accept: application/json' \
  -H 'api-key: YOUR_API_KEY'

curl -X 'GET' \
  'https://apis.propcloud.no/api/public/companies/location-history?organization-number=935112885' \
  -H 'accept: application/json' \
  -H 'api-key: YOUR_API_KEY'

curl -X 'GET' \
  'https://apis.propcloud.no/api/public/companies/location-history?batch-id=42' \
  -H 'accept: application/json' \
  -H 'api-key: YOUR_API_KEY'

curl -X 'GET' \
  'https://apis.propcloud.no/api/public/companies/location-history?updated-start-date=2025-01-01&updated-end-date=2025-06-30' \
  -H 'accept: application/json' \
  -H 'api-key: YOUR_API_KEY'

curl -X 'GET' \
  'https://apis.propcloud.no/api/public/companies/location-history?organization-number=935112885&batch-id=42&updated-start-date=2025-01-01&updated-end-date=2025-06-30' \
  -H 'accept: application/json' \
  -H 'api-key: YOUR_API_KEY'

curl -X 'GET' \
  'https://apis.propcloud.no/api/public/companies/location-history?batch-id=42&page=2&page-size=100' \
  -H 'accept: application/json' \
  -H 'api-key: YOUR_API_KEY'

Response Description

Key	Description	Beskrivelse	Source
totalPages	The total number of pages of response for this specific query.	Totalt antall sider med respons for denne spesifikke forespørselen.	PropCloud
pageSize	The number of items per page used for this response (the page-size query param, or its default of 1000).	Antall elementer per side brukt for dette svaret (page-size-parameteren, eller standardverdien 1000).	PropCloud
orgNr	Organization number	Organisasjonsnummer	Enhetsregisteret
orgName	Name of the organization	Navn på organisasjonen	Enhetsregisteret
orgForm	Organization form code (e.g. AS, ENK)	Organisasjonsformkode (f.eks. AS, ENK)	Enhetsregisteret
orgFormDescription	Human-readable description of the organization form	Lesbar beskrivelse av organisasjonsformen	Enhetsregisteret
employeeCount	Number of registered employees at the start of the interval	Antall registrerte ansatte ved intervallets start	Enhetsregisteret
propertyIdNma	PropCloud property identifier for the resolved location	PropCloud-eiendomsidentifikator for den løste lokasjonen	PropCloud
businessAddress	Raw business address string as registered in Enhetsregisteret	Rå forretningsadresse slik den er registrert i Enhetsregisteret	Enhetsregisteret
validFrom	Date when the company moved to this address (YYYY-MM-DD)	Dato da selskapet flyttet til denne adressen (YYYY-MM-DD)	Enhetsregisteret
validTo	Date when the company left this address (YYYY-MM-DD), or null if currently open. The org is not counted as present on this date itself	Dato da selskapet forlot denne adressen (YYYY-MM-DD), eller null hvis intervallet er åpent. Selskapet regnes ikke som tilstede på denne datoen	Enhetsregisteret
exitReason	Reason the interval was closed: moved (address change) or deregistered (org removed from Enhetsregisteret), or null if still open	Grunn til at intervallet ble lukket: moved (adresseendring) eller deregistered (org fjernet fra Enhetsregisteret), eller null hvis åpent	PropCloud
isLikelyInitialRegistrationAddress	true if this was likely the address used when the company was first registered; false if a later observed move confirms it was not; null if it cannot be determined (lower-bound start or missing registration date)	true hvis dette sannsynligvis var adressen ved første registrering; false hvis en senere observert flytting bekrefter at det ikke var det; null hvis det ikke kan fastslås	PropCloud
validFromIsLowerBound	true if validFrom is an estimated lower bound rather than the exact move-in date	true hvis validFrom er et estimert nedre grense og ikke den eksakte innflyttingsdatoen	PropCloud
batchId	Unique identifier for the batch of records	Unik identifikator for batchen	PropCloud
updatedAt	This timestamp field records the date and time when the data was uploaded to MongoDB.	Dette tidsstempelfeltet registrerer datoen og klokkeslettet når dataene ble lastet opp til MongoDB.	PropCloud

Request

Responses

200

Successful Response

422

Validation Error