Get location history of a company

GET 
/companies/:org_nr/location-history

Company Location History Endpoint

Overview

Returns every location interval the organization has had, sorted newest first — both resolved and unresolved.

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

Returns 404 if no intervals are found for the given organization number.

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

Example Request

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

Response Description

Key	Description	Beskrivelse	Source
orgNr	Organization number	Organisasjonsnummer	Enhetsregisteret
intervals	List of location intervals, newest first	Liste over lokasjonsintervaller, nyeste først	PropCloud
intervals[].orgNr	Organization number	Organisasjonsnummer	Enhetsregisteret
intervals[].orgName	Name of the organization	Navn på organisasjonen	Enhetsregisteret
intervals[].orgForm	Organization form code (e.g. AS, ENK)	Organisasjonsformkode (f.eks. AS, ENK)	Enhetsregisteret
intervals[].orgFormDescription	Human-readable description of the organization form	Lesbar beskrivelse av organisasjonsformen	Enhetsregisteret
intervals[].employeeCount	Number of registered employees at the start of the interval	Antall registrerte ansatte ved intervallets start	Enhetsregisteret
intervals[].propertyIdNma	PropCloud property identifier for the resolved location	PropCloud-eiendomsidentifikator for den løste lokasjonen	PropCloud
intervals[].businessAddress	Raw business address string as registered in Enhetsregisteret	Rå forretningsadresse slik den er registrert i Enhetsregisteret	Enhetsregisteret
intervals[].validFrom	Date when the company moved to this address (YYYY-MM-DD)	Dato da selskapet flyttet til denne adressen (YYYY-MM-DD)	Enhetsregisteret
intervals[].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
intervals[].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
intervals[].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
intervals[].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

Request

Responses

200

Successful Response

422

Validation Error