Publisert - 04.11.2026

Last updated

v1 (/api/v1/*) is authenticated with the X-API-KEY header; v2 (/api/v2/*) with a HelseID access token (DPoP). See Authentication. Shared topics: response format, status codes and rate limiting.

GET /api/v1/last-updated

Reports when treatment groups and reimbursement groups last changed, without returning any group data. Use it as a cheap check before a full download. See Checking for changes before downloading.

Parameters

Parameter	Type	Required	Description
`since`	`string` `YYYY-MM-DD`	No	Inclusive start date, interpreted as 00:00:00 UTC on that date. Use the ISO format `YYYY-MM-DD`. A value that is not a valid date, such as a datetime or `2026-02-30`, returns `400`. A valid future date is accepted and reports no changes.

Response

200 OK (application/json) with since=2026-10-06:

{
  "lastUpdated": "2026-10-06T03:12:44Z",
  "treatmentGroups": { "lastUpdated": "2026-10-06T03:12:44Z", "hasChanges": true },
  "reimbursementGroups": { "lastUpdated": "2026-10-01T03:10:02Z", "hasChanges": false },
  "hasChanges": true
}

Field	Description
`lastUpdated`	UTC time of the most recent change across both resource types, or `null` when there is no data.
`treatmentGroups.lastUpdated`, `reimbursementGroups.lastUpdated`	UTC time of the most recent change for that resource type, or `null` when there is no data.
`treatmentGroups.hasChanges`, `reimbursementGroups.hasChanges`	`true` when that resource type changed at or after `since` (00:00:00 UTC). Omitted when `since` is not supplied.
`hasChanges`	`true` when either resource type has changes. Omitted when `since` is not supplied.

A change is a group being added, updated, or removed (soft-deleted), and also a FEST update that changes whether a group's products are matched in FEST. These are all reported even when the default responses of the group endpoints would hide them. A sync that changes nothing does not affect lastUpdated.
The comparison is inclusive: a change at exactly 00:00:00 UTC on the since date counts.
With no data, both lastUpdated values are null and, with since, every hasChanges is false.

Status	Meaning
`200`	The change metadata above.
`400`	Invalid `since` (`application/problem+json`).
`401`	Missing or invalid credentials.

Example

# Latest change times only
curl -H "X-API-KEY: key" https://api.example.com/api/v1/last-updated

# Did anything change on or after 2026-10-06 (UTC)?
curl -H "X-API-KEY: key" "https://api.example.com/api/v1/last-updated?since=2026-10-06"

HelseID (v2) endpoints

The v2 endpoints return the same data as their v1 counterparts, authenticated with HelseID.

GET /api/v2/last-updated

Same parameters, response, and status codes as GET /api/v1/last-updated, authenticated with a HelseID DPoP access token and proof.

curl -H "Authorization: DPoP <access-token>" \
     -H "DPoP: <proof-jwt>" \
     "https://api.example.com/api/v2/last-updated?since=2026-10-06"

Søket er fullført!