Skip to content

REGION API

Municipalities and counties

Municipalities and counties by code, on the same keys, grants and allowance as the address API. Looking up a region counts as one lookup per day; /resolve is free. Resolve a name first: one name can mean several regions — Viken became three. With neither sections nor package you get the core package; package=all returns every section. A subset costs the same single lookup as the full profile.

Full answer or a subset: sections, package and meta work the same in every API.

API version
0.9.1
Endpoints
7
Sections
9
Contents

Endpoints

https://api.approach.no/api/v1/regions · OpenAPI contract

GET

/catalog

no key required

Discover versioned section and field contracts. Unauthenticated. Cacheable: ETag, 304 on If-None-Match. Narrow with category=, kind=, package= (comma-separated where several make sense) and project each descriptor with fields=. A deprecated section carries deprecated {since, sunset, successor}.

Parameters

NameTypeBounds and defaultDescription
category
query
string—Only sections in these categories (comma-separated).
kind
query
string—Only sections of these kinds (comma-separated).
package
query
string—Only the sections of this package; unknown is 400 unknown_package.
fields
query
string—Project each descriptor to these members (id is always kept); an unknown member is 400 invalid_parameter.
Datakilde-Version
header
stringdatePin a calendar date (YYYY-MM-DD), independently of the release channel. Absent means latest. A date between releases resolves to the newest contract on or before it; a date before the first resolves to the first, and a date after the latest resolves to the latest. Read Datakilde-Version on the response for the actual resolution. This does not select a historical source snapshot; only documented compatibility shims preserve older response behavior.
Datakilde-Channel
header
stringstable | preview
default stable
Independent of Datakilde-Version. Omit for stable. Preview on customer data requires an explicit preview subscription grant; packages, test keys and date pins do not grant it. Ungranted preview is refused with preview_channel_not_granted (403), never silently downgraded. Public metadata remains stable.

Responses and error codes

HTTPMeaningCodes in the body
200Section catalog (each section with its category, kind, sensitivity and time shape), the categories in display order, packages and the defaults an unqualified request gets.—
400Unknown package or fields member
GET

/catalog/sections/{section}

no key required

Get one section's contract. Unauthenticated. The catalogue descriptor of one section.

Parameters

NameTypeBounds and defaultDescription
section
path · required
string——
Datakilde-Version
header
stringdatePin a calendar date (YYYY-MM-DD), independently of the release channel. Absent means latest. A date between releases resolves to the newest contract on or before it; a date before the first resolves to the first, and a date after the latest resolves to the latest. Read Datakilde-Version on the response for the actual resolution. This does not select a historical source snapshot; only documented compatibility shims preserve older response behavior.
Datakilde-Channel
header
stringstable | preview
default stable
Independent of Datakilde-Version. Omit for stable. Preview on customer data requires an explicit preview subscription grant; packages, test keys and date pins do not grant it. Ungranted preview is refused with preview_channel_not_granted (403), never silently downgraded. Public metadata remains stable.

Responses and error codes

HTTPMeaningCodes in the body
200{api_version, catalog_version, section}—
404section_not_found
GET

/resolve

Resolve a region name or code to the regions it may mean.

Parameters

NameTypeBounds and defaultDescription
q
query
string1–100 charactersRegion name or code. A name with no exact match is retried folded (æ→ae, ø→o, å→a, accents dropped). Without q, send address_id or lat and lon.
address_id
query
string^[0-9]{1,18}$Address API address_id: answers the fylke, kommune, postnummer and grunnkrets it is filed in
lat
query
number—WGS84 latitude, with lon: placed by the nearest address within 250 m
lon
query
number—WGS84 longitude
as_of
query
stringdateResolve against the map at this date
Datakilde-Version
header
stringdatePin a calendar date (YYYY-MM-DD), independently of the release channel. Absent means latest. A date between releases resolves to the newest contract on or before it; a date before the first resolves to the first, and a date after the latest resolves to the latest. Read Datakilde-Version on the response for the actual resolution. This does not select a historical source snapshot; only documented compatibility shims preserve older response behavior.
Datakilde-Channel
header
stringstable | preview
default stable
Independent of Datakilde-Version. Omit for stable. Preview on customer data requires an explicit preview subscription grant; packages, test keys and date pins do not grant it. Ungranted preview is refused with preview_channel_not_granted (403), never silently downgraded. Public metadata remains stable.

Responses and error codes

HTTPMeaningCodes in the body
200Candidates; never choose the first automatically when several match—
400Invalid id, section, cursor or parameter
401Authentication required
402Account request allowance exhausted
403Endpoint or section not granted
404Not found
413—
429Rate limit exceeded
500—
503Source unavailable
GET

/{id}

Get all granted sections.

Parameters

NameTypeBounds and defaultDescription
id
path · required
string^[0-9]{2}$|^[0-9]{4}$Two-digit county or four-digit municipality code
sections
query
array<string>—Comma-separated section ids, each at most once. A subset fetches fewer providers and answers faster; it costs the same single lookup per subject per day as a full profile. Restricted or unavailable sections are returned with a status, not omitted. Where the family offers fields=, it selects fields within sections.
include
query
array<string>—Alias of sections, the same on every family. Send sections or include, never both.
package
query
stringall | core | labour_market | hazard_exposureCurated preset from /catalog; cannot be combined with sections. Grants still apply. With neither sections nor package the default package (core) is returned with X-Sections-Hint; package=all returns every section.
meta
query
stringfull | compact
default full
full repeats each section's complete source descriptor; compact keeps {id, version, access, max_age_hours, max_age_days} and the quality verdict. The descriptor is the /catalog entry for that id and version.
limit
query
integer1–1000
default 100
—
format
query
stringfull | summary
default full
summary answers each section's status, freshness, source and record_count without its records. Same cost as the full answer.
fields
query
string—section.field pairs, comma-separated. The named sections' records keep only those fields; other sections are unchanged. Every field must be in the section's catalogue contract. Not with format=summary.
Datakilde-Version
header
stringdatePin a calendar date (YYYY-MM-DD), independently of the release channel. Absent means latest. A date between releases resolves to the newest contract on or before it; a date before the first resolves to the first, and a date after the latest resolves to the latest. Read Datakilde-Version on the response for the actual resolution. This does not select a historical source snapshot; only documented compatibility shims preserve older response behavior.
Datakilde-Channel
header
stringstable | preview
default stable
Independent of Datakilde-Version. Omit for stable. Preview on customer data requires an explicit preview subscription grant; packages, test keys and date pins do not grant it. Ungranted preview is refused with preview_channel_not_granted (403), never silently downgraded. Public metadata remains stable.

Responses and error codes

HTTPMeaningCodes in the body
200Subject with each section's own status
304Not modified: If-None-Match named the current ETag. No body, never counted.—
400Invalid id, section, cursor or parameter
401Authentication required
402Account request allowance exhausted
403Endpoint or section not granted
404Not found
413—
429Rate limit exceeded
500—
503Source unavailable
GET

/{id}/children

The kommuner of a fylke; the grunnkretser and postnummer areas of a kommune.

Parameters

NameTypeBounds and defaultDescription
id
path · required
string—Two digits (fylke), four (kommune), eight (grunnkrets) or postnummer:NNNN
Datakilde-Version
header
stringdatePin a calendar date (YYYY-MM-DD), independently of the release channel. Absent means latest. A date between releases resolves to the newest contract on or before it; a date before the first resolves to the first, and a date after the latest resolves to the latest. Read Datakilde-Version on the response for the actual resolution. This does not select a historical source snapshot; only documented compatibility shims preserve older response behavior.
Datakilde-Channel
header
stringstable | preview
default stable
Independent of Datakilde-Version. Omit for stable. Preview on customer data requires an explicit preview subscription grant; packages, test keys and date pins do not grant it. Ungranted preview is refused with preview_channel_not_granted (403), never silently downgraded. Public metadata remains stable.

Responses and error codes

GET

/{id}/geometry

The region's boundary as a GeoJSON Feature (EPSG:4326, simplified).

Parameters

NameTypeBounds and defaultDescription
id
path · required
string—Two digits (fylke), four (kommune), eight (grunnkrets) or postnummer:NNNN
Datakilde-Version
header
stringdatePin a calendar date (YYYY-MM-DD), independently of the release channel. Absent means latest. A date between releases resolves to the newest contract on or before it; a date before the first resolves to the first, and a date after the latest resolves to the latest. Read Datakilde-Version on the response for the actual resolution. This does not select a historical source snapshot; only documented compatibility shims preserve older response behavior.
Datakilde-Channel
header
stringstable | preview
default stable
Independent of Datakilde-Version. Omit for stable. Preview on customer data requires an explicit preview subscription grant; packages, test keys and date pins do not grant it. Ungranted preview is refused with preview_channel_not_granted (403), never silently downgraded. Public metadata remains stable.

Responses and error codes

GET

/{id}/sections/{section}

Get one section with pagination.

Parameters

NameTypeBounds and defaultDescription
id
path · required
string^[0-9]{2}$|^[0-9]{4}$Two-digit county or four-digit municipality code
section
path · required
stringidentity | employment | population | industry | vacancies | income | public_health | storm_surge_municipal_exposure | construction_activity—
cursor
query
string——
limit
query
integer1–1000
default 100
—
meta
query
stringfull | compact
default full
full repeats each section's complete source descriptor; compact keeps {id, version, access, max_age_hours, max_age_days} and the quality verdict. The descriptor is the /catalog entry for that id and version.
format
query
stringfull | summary
default full
summary answers each section's status, freshness, source and record_count without its records. Same cost as the full answer.
fields
query
string—section.field pairs, comma-separated. The named sections' records keep only those fields; other sections are unchanged. Every field must be in the section's catalogue contract. Not with format=summary.
Datakilde-Version
header
stringdatePin a calendar date (YYYY-MM-DD), independently of the release channel. Absent means latest. A date between releases resolves to the newest contract on or before it; a date before the first resolves to the first, and a date after the latest resolves to the latest. Read Datakilde-Version on the response for the actual resolution. This does not select a historical source snapshot; only documented compatibility shims preserve older response behavior.
Datakilde-Channel
header
stringstable | preview
default stable
Independent of Datakilde-Version. Omit for stable. Preview on customer data requires an explicit preview subscription grant; packages, test keys and date pins do not grant it. Ungranted preview is refused with preview_channel_not_granted (403), never silently downgraded. Public metadata remains stable.

Responses and error codes

HTTPMeaningCodes in the body
200One section; follow next_cursor for more records
304Not modified: If-None-Match named the current ETag. No body, never counted.—
400Invalid id, section, cursor or parameter
401Authentication required
402Account request allowance exhausted
403Endpoint or section not granted
404Not found
413—
429Rate limit exceeded
500—
503Source unavailable

Sections

IdTitle and sourceDetails
identityWhat this region code is, and when it was in force
SSB Klass (Standard for kommune- og fylkesinndeling)
Caveats
  • A region code is not a permanent identity. 293 names have been held under more than one code since 1990, counties merged in 2020 and were partly divided again in 2024, and 438 municipal codes changed between 2019 and 2025. valid_to tells you when this code stopped meaning anything; became names what replaced it. Figures from different periods are not comparable across a boundary change without saying so.
11 fields · region
employmentPeople working here and living here, by year
SSB table 11618, register-based employment
Caveats
  • Register-based and annual at 4th quarter, so it is complete rather than sampled but roughly a year behind. by_workplace counts jobs located here; by_residence counts employed people living here, wherever they work. workplace_ratio above 1 means the region imports labour and below 1 exports it. Years in which this code was not in force are absent rather than zero.
10 fields · region
populationAge profile by period
SSB befolkningsstatistikk
Caveats
  • Both sexes summed. Age bands are the source's own and are not always contiguous; do not add them expecting a total. A region absent from a period did not exist under this code then.
6 fields · region
industryWhich industries employ people here
Brønnøysund Enhetsregisteret, aggregated by Approach
Caveats
  • Counted from the company register by the address a company registers, which is not always where its people work: a group registered in Oslo with plants elsewhere counts as Oslo. Employees are what companies last reported to the register and are missing for many small ones, so totals understate. Kommune only; a fylke code returns nothing.
  • active_companies counts companies whose register status is aktiv; companies in bankruptcy (konkurs), compulsory or voluntary liquidation (tvangsavvikling, avvikling) and deleted companies are excluded, and total_employees, total_revenue and avg_revenue are summed over the same active companies. registered_companies also counts the bankrupt and liquidating companies still in the register; deleted companies are in neither.
  • total_revenue sums each active company's most recent company accounts (regnskapstype SELSKAP, not the consolidated KONSERN accounts) that carry a revenue figure, and avg_revenue is the mean over the companies that have one. Companies file for different years, so one row mixes fiscal years, mostly the latest two; a company without filed accounts, which is most sole traders, contributes nothing to either.
9 fields · region
vacanciesWhat employers here are advertising, last 90 days
NAV Arbeidsplassen
Caveats
  • Advertised positions, not hires and not vacancies: one listing may fill many posts or none, and employers who never advertise are invisible. The only high-frequency regional labour signal here -- everything else on this subject is annual. Kommune only.
  • Listings name their kommune and fylke; they carry no code. A listing counts here when both names agree with the register for this code, or, when it names no fylke, when the kommune name is unique among current kommuner (Herøy, Våler, Nes and Sande are not). A listing whose kommune name the register spells differently, or published under a name this code never held, is left out rather than counted elsewhere.
7 fields · region
incomeHousehold income by year
SSB inntektsstatistikk for husholdninger
Caveats
  • Annual and published about two years in arrears, so the newest year here is not the current one.
  • median_income is the median total household income before tax; median_household_after_tax_income_nok is the median after tax. SSB 06944 publishes medians only.
  • mean_income is deprecated and always null: it was the after-tax median under a wrong name.
7 fields · region
public_healthPublic-health indicators from the Norwegian Institute of Public Health
FHI Folkehelsestatistikk (Statistikk Open API, saved copy)
Caveats
  • A handful of FHI indicators (people living alone, drinking-water supply, income inequality), each as the overall figure for the place: no age, sex or other breakdown. Kommune and fylke. period is FHI's own code, for example 2024_2024 for a year or 2020_2024 for a five-year window, and measure says what value counts (a share, a count, an index).
  • Annual and published in arrears, so the newest period is not the current year. A place or indicator FHI does not publish for is simply absent. Some indicators are suppressed for small populations by FHI itself; a missing row is not a zero.
  • Licence: FHI publishes under NLOD 2.0; attribute the Norwegian Institute of Public Health. Sensitive indicators such as suicide counts are not served.
9 fields · region
storm_surge_municipal_exposureBuildings, roads and land below storm-surge levels, today and with sea-level rise
Kartverket stormflo-konsekvens API (no conditions apply)
Caveats
  • Kommune statistics from Kartverket's storm-surge consequence analysis: how many buildings, metres of road and square metres of land lie below each extreme water level, at today's sea level (2025) and with the sea-level rise expected by 2100 or 2150. A benchmark for the kommune, not an answer for any one address: storm_surge_zones and sea_level_projection answer whether the address itself is inside a zone.
  • Kartverket notes that the dataset is not suited to detailed studies or decisions at plot level. Counts are of objects whose footprint intersects the flooded area; waves, wind set-up and local protection are not modelled. Only coastal kommuner are in the source; an inland kommune has no rows, which is not the same as zero exposure being computed.
  • Kommune only; a fylke code returns nothing.
20 fields · region
construction_activityRegional vegetation change (Sentinel-2), by month
Copernicus Sentinel-2 L2A (Copernicus Data Space Ecosystem), NDVI change computed by Approach
Caveats
  • Compatibility ID: construction_activity. The legacy field name signals means only that the area-average NDVI drop crossed a heuristic threshold; this is not a construction detector or register. A signal is a fall in mean vegetation index (NDVI) over a monitored box of a few square kilometres between the last 30 days and the same 30 days a year earlier. Land clearing, demolition, excavation and large new sealed surfaces lower it; so do harvest, drought, flooding, a late spring and cloud or snow the scene mask missed. It does not count buildings, building permits or starts, and a quiet month is not proof that nothing was built.
  • Sentinel-2 pixels are 10 to 20 metres, and the comparison is a mean over the whole box, so a single house or a small site does not move it: only work large enough to change a noticeable share of a few square kilometres shows. signals_*_confidence splits signals by the size of the drop and the share of the box both scenes actually saw (high: a drop of at least 0.25 with half the box observed; medium: at least 0.15 with 30 per cent).
  • Coverage is a handful of monitored areas in Oslo, Bergen, Trondheim, Stavanger and Drammen. Any other kommune answers unavailable with error not_covered, and before the pipeline has produced its first comparison every kommune answers unavailable with source_not_loaded. Kommune only; a fylke code returns nothing.
  • Monthly, and seasonal: from about November to March low sun and snow leave few usable pixels in Norway, so winter months are often missing rather than zero. comparisons counts the area comparisons made in the month and signals those past the threshold.
  • Licence: Copernicus Sentinel data, free and open with attribution. Show the record's attribution ("Contains modified Copernicus Sentinel data" and the year) with any figure from this section.
12 fields · region