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.

API version: 0.3.0
Endpoints: 4
Sections: 7

Contents

Endpoints

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

GET

/catalog

no key required

Discover versioned section and field contracts.

Takes no parameters.

Responses and error codes

HTTP	Meaning	Codes in the body
200	Section catalog	—

GET

/resolve

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

Parameters

Name	Type	Bounds and default	Description
q query · required	string	1–100 characters	Region name or code
as_of query	string	date	Resolve against the map at this date

Responses and error codes

HTTP	Meaning	Codes in the body
200	Candidates; never choose the first automatically when several match	—
400	Invalid id, section, cursor or parameter	—
401	Authentication required	authentication_required reason: expired internal_token_invalid invalid_api_key reason: ip_not_allowlisted reason: key_credit_budget_exhausted reason: not_found reason: revoked reason: unknown_key_format
402	Account request allowance exhausted	monthly_safety_cap_reached product_plan_required request_allowance_exhausted request_allowance_insufficient test_daily_cap_reached test_monthly_cap_reached
403	Endpoint or section not granted	active_partner_grant_required address_endpoint_not_allowed admin_mode_key_revoked approved_address_access_required customer_not_member reason: customer_required internal_product_not_allowed reason: invalid_key_id reason: ip_allowlisted_key_requires_direct_call reason: key_not_owned_by_customer selected_key_unavailable reason: session_required
404	Not found	—
429	Rate limit exceeded	rate_limit_exceeded too_many_failed_authentications
500	—	internal_error
503	Source unavailable	access_policy_unavailable auth_unavailable busy meter_unavailable

GET

/{id}

Get all granted sections.

Parameters

Name	Type	Bounds and default	Description
id path · required	string	^[0-9]{2}$\|^[0-9]{4}$	Two-digit county or four-digit municipality code
sections query	string	—	Comma-separated section ids from /catalog
limit query	integer	1–1000 default `100`	—

Responses and error codes

HTTP	Meaning	Codes in the body
200	Subject with each section's own status	—
400	Invalid id, section, cursor or parameter	—
401	Authentication required	authentication_required reason: expired internal_token_invalid invalid_api_key reason: ip_not_allowlisted reason: key_credit_budget_exhausted reason: not_found reason: revoked reason: unknown_key_format
402	Account request allowance exhausted	monthly_safety_cap_reached product_plan_required request_allowance_exhausted request_allowance_insufficient test_daily_cap_reached test_monthly_cap_reached
403	Endpoint or section not granted	active_partner_grant_required address_endpoint_not_allowed admin_mode_key_revoked approved_address_access_required customer_not_member reason: customer_required internal_product_not_allowed reason: invalid_key_id reason: ip_allowlisted_key_requires_direct_call reason: key_not_owned_by_customer selected_key_unavailable reason: session_required
404	Not found	—
429	Rate limit exceeded	rate_limit_exceeded too_many_failed_authentications
500	—	internal_error
503	Source unavailable	access_policy_unavailable auth_unavailable busy meter_unavailable

GET

/{id}/sections/{section}

Get one section with pagination.

Parameters

Name	Type	Bounds and default	Description
id path · required	string	^[0-9]{2}$\|^[0-9]{4}$	Two-digit county or four-digit municipality code
section path · required	string	identity \| employment \| population \| industry \| vacancies \| income \| storm_surge_municipal_exposure	—
cursor query	string	—	—
limit query	integer	1–1000 default `100`	—

Responses and error codes

HTTP	Meaning	Codes in the body
200	One section; follow next_cursor for more records	—
400	Invalid id, section, cursor or parameter	—
401	Authentication required	authentication_required reason: expired internal_token_invalid invalid_api_key reason: ip_not_allowlisted reason: key_credit_budget_exhausted reason: not_found reason: revoked reason: unknown_key_format
402	Account request allowance exhausted	monthly_safety_cap_reached product_plan_required request_allowance_exhausted request_allowance_insufficient test_daily_cap_reached test_monthly_cap_reached
403	Endpoint or section not granted	active_partner_grant_required address_endpoint_not_allowed admin_mode_key_revoked approved_address_access_required customer_not_member reason: customer_required internal_product_not_allowed reason: invalid_key_id reason: ip_allowlisted_key_requires_direct_call reason: key_not_owned_by_customer section_not_available_to_product selected_key_unavailable reason: session_required
404	Not found	—
429	Rate limit exceeded	rate_limit_exceeded too_many_failed_authentications
500	—	internal_error
503	Source unavailable	access_policy_unavailable auth_unavailable busy meter_unavailable

Sections

Id	Title and source	Details
identity	What 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
employment	People 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
population	Age 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
industry	Which 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.	8 fields · region
vacancies	What 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.	7 fields · region
income	Household 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
storm_surge_municipal_exposure	Buildings, 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