KS Besøksbidrag

Short description

Reporting of visitor levy (besøksbidrag) for accommodation providers and intermediaries.

KS Besøksbidrag is a national service that helps Norwegian municipalities administer the visitor levy introduced through the Besøksbidragsloven. This page is for accommodation providers, booking platforms and other intermediaries, and for vendors building systems for them. It explains how to find out which municipalities and periods have a visitor levy, and how to report turnover.

The service offers:

• An open municipality register (Register API) of municipalities with visitor levy, and the periods in which it applies
• Reporting of accommodation turnover through an Altinn form (coming)
• Reporting through an API for automated submission from your own systems (coming)

Status: Currently only the Register API is available. The API may change until 1 December. The reporting schema will be published through Altinn later, and this page will be updated when it is ready.

Who is this for?

• Accommodation providers: hotels, campsites, cabin operators and private hosts who must report turnover subject to visitor levy and want to use the APIs.
• Intermediaries: booking platforms and others who report on behalf of accommodation providers who want to use the APIs.
• System vendors: vendors of booking, PMS and accounting systems that will support automated reporting via the APIs.

Available interfaces

Getting started

1. Use the Register API to find out which municipalities have visitor levy, and which periods apply. You can call it directly.
2. Reporting: the form and any reporting API are not yet published. See API reference for status.

The Register API is open. It requires no authentication, integration or activation.

Description of the service

Concepts and terms

Overall flow

1. Look up in the Register API which municipalities have visitor levy, and in which periods.
2. Report turnover for stays in covered municipalities and periods, manually through Altinn or automatically through the API (coming).
3. KS Besøksbidrag validates the data and calculates the invoice basis for the municipality.
4. The municipality invoices and follows up in its own finance system.

Service-specific rules

• The register contains municipalities with at least one configured period.
• Recurring periods are shown for the current calendar year and the following nine years.
• The response is cached and may be up to 10 minutes old. Do not poll more often than necessary.
• regulationEffectiveDate may be null if the value has not been set by the municipality.
• Reporting rules (what to report, deadlines and format) will be published on Min kommune when ready.

API reference

Register API

API spec for KS Besøksbidrag Register

Base URL per environment:

• Test: https://api.test.fiks.ks.no/besoksbidrag-register/api/v1
• Production: https://api.fiks.ks.no/besoksbidrag-register/api/v1

Example:

curl https://api.fiks.ks.no/besoksbidrag-register/api/v1/municipalities

{
  "municipalities": [
    {
      "organizationNumber": "958935420",
      "municipalityNumber": "0301",
      "municipalityName": "Oslo kommune",
      "regulationEffectiveDate": "2026-07-01",
      "periods": [
        { "startDate": "2027-04-15", "endDate": "2027-09-15" }
      ]
    }
  ]
}

Reporting API and schema

Not published yet. The schema will come through Altinn, and the API specification for automated reporting will be linked here when ready.

Service-specific errors

Errors are returned in the standard error format (Norwegian). The Register API may return:

Versioning