API Reference

All endpoints require the X-API-KEY header. See Authentication.

GET /api/v1/treatmentGroup

Returns treatment group data.

Parameters

Response

{
  "currentVersion": 5,
  "items": [
    {
      "data": { ... },
      "version": 5,
      "lastChanged": "2025-04-10T08:30:00Z",
      "isDeleted": false
    }
  ]
}

Without sinceVersion: Returns all non-deleted items. isDeleted is always false.

With sinceVersion: Returns items with version > N, including deleted items. isDeleted may be true for items that were removed from the source system.

Example

# Get all
curl -H "X-API-KEY: key" \
  https://api.example.com/api/v1/treatmentGroup

# Get changes since version 3
curl -H "X-API-KEY: key" \
  https://api.example.com/api/v1/treatmentGroup?sinceVersion=3

GET /api/v1/reimbursementGroup

Returns reimbursement group data (legal basis, indications, covered medicines).

Parameters

Response

{
  "currentVersion": 5,
  "items": [
    {
      "data": {
        "id": "...",
        "legalBasis": { "coding": [ { "system": "...", "code": "950", "display": "H-resept" } ] },
        "indications": [ { "coding": [ { "system": "...", "code": "G35", "display": "Multiple sclerosis" } ] } ],
        "medicines": [
          {
            "reference": null,
            "type": "FEST/LegemiddelPakning",
            "identifier": { "system": "FEST/Varenummer", "value": "166028" },
            "display": null
          }
        ]
      },
      "version": 5,
      "lastChanged": "2025-04-10T08:30:00Z",
      "isDeleted": false
    }
  ]
}

Behavior is identical to the treatmentGroup endpoint. The medicines array is empty if upstream provides no article number for the authorization.

Example

# Get all
curl -H "X-API-KEY: key" \
  https://api.example.com/api/v1/reimbursementGroup

# Get changes since version 3
curl -H "X-API-KEY: key" \
  https://api.example.com/api/v1/reimbursementGroup?sinceVersion=3

Response Envelope

All endpoints return data in the same envelope:

{
  currentVersion: number;     // The server's current data version
  items: Array<{
    data: T;                  // The actual data object
    version: number;          // Version when this item last changed
    lastChanged: string;      // ISO-8601 timestamp of last change
    isDeleted: boolean;       // Whether this item has been removed
  }>;
}

HTTP Status Codes

Rate Limiting

There are currently no rate limits enforced. Please be reasonable with request frequency — the data only changes once per day (after the nightly sync).