Maskinporten Integration Guide

This guide helps you integrate with the Norwegian Customs APIs that use Maskinporten for authentication.

The guide is written for both Norwegian businesses (with a Norwegian organisation number) and foreign businesses (without one). The approach is mainly the same, but differs especially in what type of certificate is required.

How it fits together

Setting up an integration can be split into three steps:

  1. Order a certificate – obtain a certificate that identifies your business.
  2. Onboarding – register with Norwegian Customs and Digdir, and create the integration.
  3. Technical integration – get an access token from Maskinporten, exchange it for a Customs-signed token, and call the Customs APIs.

Two roles are involved in an integration: the business that owns the certificate and holds the agreements (steps 1 and 2), and the system provider that develops the integration itself (step 3).

If you are unsure what Maskinporten is, start with What is Maskinporten?