Quickstart

This guide walks through fetching property data for a Norwegian cadastre number in under five minutes.

1. Get a token

Replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with your credentials:

TOKEN=$(curl -s -X POST https://v1-customer-api.placepoint.no/auth \
  --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. Query a plot

Use a Norwegian cadastre number in the format KOMMUNENR-GARDSNR/BRUKSNR:

curl -X POST https://v1-customer-api.placepoint.no/v1/plots \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cadastreNumbers": ["0301-1/2"]
  }'

Example response:

{
  "plots": [
    {
      "cadastreNumber": "0301-1/2",
      "area": 4820,
      "areaUnit": "m2",
      "municipalityNumber": "0301",
      "municipalityName": "Oslo"
    }
  ]
}

3. Query buildings on the same plot

curl -X POST https://v1-customer-api.placepoint.no/v1/buildings \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cadastreNumbers": ["0301-1/2"]
  }'

4. Look up the owners

curl -X POST https://v1-customer-api.placepoint.no/v1/owners \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cadastreNumbers": ["0301-1/2"]
  }'

Next steps

• Read the full Customer API reference to see all available fields and endpoints.
• Learn how to search for addresses with the Matching API.
• Explore embedding maps with the Embed Service.