Quickstart

Get a token, look up a Norwegian property, list its tenants, and subscribe to change events. Under 10 minutes.

1. Get a token

Sign in with GitHub on any docs.placepoint.no/api page for a trial key in under a minute, no payment card. It works today against the Leietaker-API and the current Data API, and the Placepoint API accepts the same key at launch. Set it as TOKEN.

With production credentials from Placepoint (a ppk_live_ client id and secret), request a token instead:

TOKEN=$(curl -s -X POST https://data.placepoint.no/auth/token \
  --data-urlencode "grant_type=client_credentials" \
  --data-urlencode "client_id=YOUR_CLIENT_ID" \
  --data-urlencode "client_secret=YOUR_CLIENT_SECRET" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

2. Look up a property

Norwegian cadastre numbers (matrikkelnummer) use knr-gnr-bnr[-fnr[-snr]]; see Identifiers for the full breakdown.

curl https://data.placepoint.no/properties/NO/0301-208-15-0-0 \
  -H "Authorization: Bearer $TOKEN"

{
  "country": "NO",
  "cadastreId": "0301-208-15-0-0",
  "municipality": { "code": "0301", "name": "Oslo" },
  "areaM2": 620,
  "propertyType": "EIERSEKSJON",
  "addresses": [
    { "text": "Dronning Eufemias gate 16, 0191 Oslo", "streetName": "Dronning Eufemias gate", "houseNumber": "16", "postalCode": "0191", "postalPlace": "Oslo", "country": "NO" }
  ]
}

3. List its tenants

Companies with a registered business address on the property, sourced from Brønnøysundregistrenes Enhetsregisteret.

curl https://data.placepoint.no/properties/NO/0301-208-15-0-0/tenants \
  -H "Authorization: Bearer $TOKEN"

{
  "items": [
    {
      "organization": { "organizationIdentifier": { "scheme": "0192", "id": "923456789" }, "name": "Nordic Consulting AS", "country": "NO" },
      "verification": { "source": "ENHETSREGISTERET", "confidence": "HIGH", "lastSeenAt": "2026-08-15T02:00:00Z" },
      "employees": 42,
      "naceCode": "70.220",
      "naceName": "Bedriftsrådgivning"
    }
  ]
}

4. Subscribe to changes

Create a webhook.site URL to receive test deliveries, then subscribe to owner and transaction changes on the property:

curl -X POST https://data.placepoint.no/subscriptions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "target": { "kind": "PROPERTY", "country": "NO", "cadastreId": "0301-208-15-0-0" },
    "events": ["OWNER_CHANGED", "TRANSACTION_REGISTERED"],
    "webhookUrl": "https://webhook.site/YOUR-UUID",
    "secret": "whsec_REPLACE_WITH_32_RANDOM_CHARS"
  }'

{
  "id": "sub_9f2c1a",
  "target": { "kind": "PROPERTY", "country": "NO", "cadastreId": "0301-208-15-0-0" },
  "events": ["OWNER_CHANGED", "TRANSACTION_REGISTERED"],
  "webhookUrl": "https://webhook.site/YOUR-UUID",
  "status": "ACTIVE",
  "createdAt": "2026-09-07T10:15:00Z"
}

See Webhooks for the delivery format and signature verification.

Until the Placepoint API launches, these calls answer from the current Leietaker-API for tenants, and from the contract examples shown above and in the reference elsewhere.

Next steps

Read the full reference for every resource, including companies, areas and Swedish properties (SE in place of NO).