Identifiers
The API keys properties on a national cadastre number and companies on a national organization register. Both use an ISO scheme code so the same 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: ISO 6523
Companies are identified by an ISO 6523 ICD scheme code plus the register's own identifier, the same pair Peppol uses:
| Scheme | Register |
|---|---|
0192 | Norwegian organisasjonsnummer (Enhetsregisteret) |
0007 | Swedish organisationsnummer (Bolagsverket) |
GET /companies/0192/987654321
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