REGION-API

Kommuner og fylker

Kommuner og fylker på nummer, med de samme nøklene, tilgangene og kvoten som adresse-API-et. Et oppslag av en region teller som ett oppslag per døgn; /resolve er gratis. Slå opp et navn først: ett navn kan bety flere regioner — Viken ble tre.

API-versjon: 0.3.0
Endepunkter: 4
Seksjoner: 7

Innhold

Endepunkter

https://api.approach.no/api/v1/regions · OpenAPI-kontrakt

GET

/catalog

uten nøkkel

Discover versioned section and field contracts.

Tar ingen parametere.

Svar og feilkoder

HTTP	Betydning	Koder i svaret
200	Section catalog	—

GET

/resolve

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

Parametere

Navn	Type	Grenser og standard	Beskrivelse
q spørring · påkrevd	string	1–100 tegn	Region name or code
as_of spørring	string	date	Resolve against the map at this date

Svar og feilkoder

HTTP	Betydning	Koder i svaret
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.

Parametere

Navn	Type	Grenser og standard	Beskrivelse
id sti · påkrevd	string	^[0-9]{2}$\|^[0-9]{4}$	Two-digit county or four-digit municipality code
sections spørring	string	—	Comma-separated section ids from /catalog
limit spørring	integer	1–1000 standard `100`	—

Svar og feilkoder

HTTP	Betydning	Koder i svaret
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.

Parametere

Navn	Type	Grenser og standard	Beskrivelse
id sti · påkrevd	string	^[0-9]{2}$\|^[0-9]{4}$	Two-digit county or four-digit municipality code
section sti · påkrevd	string	identity \| employment \| population \| industry \| vacancies \| income \| storm_surge_municipal_exposure	—
cursor spørring	string	—	—
limit spørring	integer	1–1000 standard `100`	—

Svar og feilkoder

HTTP	Betydning	Koder i svaret
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

Seksjoner

Id	Tittel og kilde	Detaljer
identity	What this region code is, and when it was in force SSB Klass (Standard for kommune- og fylkesinndeling) Forbehold 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 felter · region
employment	People working here and living here, by year SSB table 11618, register-based employment Forbehold 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 felter · region
population	Age profile by period SSB befolkningsstatistikk Forbehold 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 felter · region
industry	Which industries employ people here Brønnøysund Enhetsregisteret, aggregated by Approach Forbehold 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 felter · region
vacancies	What employers here are advertising, last 90 days NAV Arbeidsplassen Forbehold 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 felter · region
income	Household income by year SSB inntektsstatistikk for husholdninger Forbehold 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 felter · 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) Forbehold 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 felter · region