Publisert - 07.11.2025

PMD API Specification

General

PMD implements a subset of FHIR REST API specification, with following restrictions:

  • All endpoints are guarded by HelseID (see Security Concerns).
  • Only one resource type is available: Observation (see Observation).
  • Bundle endpoint only accepts Observation resources referring to existing patients, either by logical reference or fødselsnummer (see Bundle).

Environments

Environment URL Usage
Dev pmd.dev.nhn.no Internal development environment
Test pmd.test.nhn.no For testing purposes outside of Norsk Helsenett
Production pmd.nhn.no (*) Production environment

(*) the Production environment is only available at Helsenettet.

Security Concerns

To use the PMD API the client MUST implement HelseID with DPoP. Refer to HelseID documentation and their official support channels for more information about HelseID, OpenID Connect and DPoP.

The end users must log in at security level 4 (BankID or Buypass Security).

Bundle endpoint

Endpoint for uploading bundles is the root URL, e.g. https://pmd.dev.nhn.no/ for the internal development environment. All parsable resources inside the bundle will be saved in the database as if they were a batch upload.

Resource: Observation

Clients can expect to find Observation resources to the Base observation profile , as well as the Observation variant from VKP (Velferdsteknologisk Knutepunkt) - VkpObservation - as described here:

Create

POST [base_url]/Observation/

See examples

POST [base_url]/Observation/_search

See examples

Notes:

  • Observation search will only return results for one patient at a time.
  • Search through GET parameters is not allowed.
  • Following filters are available:
    • date (comparators eq, ge, gt, lt, le, see FHIR search prefixes)
    • code
    • patient.identifier currently implemented as header X-Pmd-Patient

References