Identifiers
The API keys properties on a national cadastre number and companies on a national organization register. Both are addressed the same way: the ISO 3166-1 country code, then the register's own identifier, so one path shape works for Norway and Sweden.
Countries
Every property, address, area and coordinate lookup takes a country path parameter: the ISO 3166-1 alpha-2 code, NO or SE.
Properties: matrikkelnummer and fastighetsbeteckning
Norwegian properties use the Matrikkelen's matrikkelnummer, knr-gnr-bnr[-fnr[-snr]]:
| Part | Name | Meaning |
|---|---|---|
knr | Kommunenummer | 4-digit municipality code. |
gnr | Gårdsnummer | Cadastral unit (farm) number within the municipality. |
bnr | Bruksnummer | Property number within the gårdsnummer. |
fnr | Festenummer | Optional: leasehold plot number, when the property is leased land. |
snr | Seksjonsnummer | Optional: unit number, when the property is a sectioned unit (eierseksjon). |
Example: 0301-208-15-0-0 is kommune 0301 (Oslo), gårdsnummer 208, bruksnummer 15, no festenummer, no seksjonsnummer.
GET /properties/NO/0301-208-15-0-0
Swedish properties use the fastighetsbeteckning, slugged the way Combify serves it: lowercase, spaces to underscores, e.g. 0184_svardsliljan_1_1 for "Solna Svärdsliljan 1:1".
GET /properties/SE/0184_svardsliljan_1_1
Organizations: country code and organization number
A company is identified by its country and the organization number the national register issues:
| Country | Register | Number |
|---|---|---|
NO | Enhetsregisteret (Brønnøysundregistrene) | organisasjonsnummer, nine digits |
SE | Bolagsverket | organisationsnummer, ten digits |
GET /companies/NO/987654321
Responses carry the same pair as organizationIdentifier:
{ "organizationIdentifier": { "country": "NO", "id": "987654321" } }
Send the number as digits only. A Swedish organisationsnummer is written with a hyphen (556012-5790) and accepted either way, but the responses print it unhyphenated.
The API took an ISO 6523 ICD scheme code here until 0.2.0 (0192 for Norway, 0007 for Sweden). Those codes are known to people who work with Peppol and e-invoicing and to almost nobody else, and the property endpoints already used a country code, so the company endpoints were the odd ones out. See the changelog for what to rewrite.
Addresses
An address lookup takes the country and the full address as a path segment, URL-encoded:
GET /addresses/NO/Karl%20Johans%20gate%201%2C%20Oslo
Karl Johans gate 1, Oslo becomes Karl%20Johans%20gate%201%2C%20Oslo: spaces as %20, the comma as %2C. Encode the whole address, not just the parts that look unsafe; a client library's URL encoder (not manual string concatenation) gets this right by default.
Coordinates
A coordinate lookup takes latitude and longitude as separate path segments:
GET /coordinates/NO/59.9075/10.7563