Getting Started

Overview

The Nompd API provides Norwegian healthcare treatment group and reimbursement data in a simplified REST format. Data is sourced from the national FHIR APIs and kept up to date via nightly synchronization.

Prerequisites

You need an API key to access the API. Contact the Nompd team to request one.

Your First Request

All requests require an X-API-KEY header:

curl https://nompd-api.example.com/api/v1/treatmentGroup \
  -H "X-API-KEY: your-api-key"

Response

{
  "currentVersion": 5,
  "items": [
    {
      "data": {
        "id": "4077eb19-b094-4712-89b1-c3b5a021ef8d",
        "name": "Natalizumab",
        "description": "Rangering av natalizumab s.c og i.v formulering",
        "diseaseGroup": "MS",
        "jurisdictions": [
          {
            "system": "urn:oid:2.16.578.1.12.4.1.102",
            "code": "100022",
            "display": "Helse Nord RHF"
          }
        ],
        "validityPeriod": {
          "start": "2025-05-01",
          "end": "2027-04-30"
        },
        "reviewDate": "2025-04-10",
        "indications": [
          {
            "coding": [
              {
                "system": "urn:oid:2.16.578.1.12.4.1.1.7110",
                "code": "G35",
                "display": "Multippel sklerose"
              }
            ],
            "text": "Multiple sclerosis"
          }
        ],
        "treatmentAlternatives": [
          {
            "rank": 1,
            "treatmentId": "6d3c0e9f-dd3f-49e6-8c6c-c3ef1ccdfa1a",
            "name": "Natalizumab (Tysabri)",
            "description": null,
            "medicines": [
              {
                "reference": null,
                "type": "FEST/LegemiddelPakning",
                "identifier": {
                  "system": "FEST/Varenummer",
                  "value": "166028"
                },
                "display": null
              }
            ]
          }
        ]
      },
      "version": 5,
      "lastChanged": "2025-04-10T08:30:00Z",
      "isDeleted": false
    }
  ]
}

Key Concepts

• currentVersion — The server's current data version. Store this value to use with diff queries later.
• items — Array of data items, each wrapped with per-document metadata.
• version — The version when this specific item last changed. Useful for tracking individual updates.
• lastChanged — Timestamp of last modification.
• isDeleted — Always false when fetching without sinceVersion. Relevant when using diff queries (see Versioning and Diff).

Available Endpoints

Both endpoints support an optional ?sinceVersion=N query parameter for incremental updates.

Next Steps

• API Reference — Full endpoint documentation
• Versioning and Diff — How to fetch only changes
• Data Models — Field descriptions and code systems
• Authentication — API key details