Publisert - 28.04.2026

Get Notifications

For detailed technical specifications, please refer to the Swagger documentation.

Fetch Notifications

GET /notifications

Returns an array of notifications for one or more HER-Ids.

Query Parameters

Parameter Type Required Description
HerIds integer[] ✅ One or more receiver HER-Ids to fetch notifications for. Max 1500 HER-Ids can be provided in one request.
NotificationsToFetch integer - Number of notifications to return. Default is 100. Must be between 1 and 1000 if provided.
Offset integer ✅ Offset of the last notification received from this endpoint, ensures only newer notifications are returned.

Response

The response contains a notifications array. Each notification object has the following fields:

Field Type Description
relatedMessageId guid ID of the related message. Use this ID when interacting with the message-endpoints.
type string Type of notification. Either NewMessage, RefusedMessage, MessageSentStateUpdated or MessageApprecInfoUpdated.
notificationReceiverHerId integer The HER-Id of the receiver this notification is for.
notificationTriggeredByHerId integer The HER-Id of the party that triggered the notification (e.g. the sender).
description string Human-readable description of the notification event.
createdAt datetime Timestamp for when the notification was created.
offset integer The offset value for this notification. Use this as the Offset parameter in subsequent requests.

Notification Types

NewMessage

A new business document has been received and is ready for download. Use relatedMessageId to get message data from the GET /messages/{id}/*-endpoints.

RefusedMessage

Not yet enabled in Test and Production

A message could not be delivered. The description field contains the reason, e.g. "Receiver does not support the message type: 'EPIKRISE'.". You cannot download a business document for refused messages.

This feature must be enabled for your HER-Id. See the configuration endpoint page.

MessageSentStateUpdated

Confirms that the message handler has successfully dispatched the message to the intended receiver. The notification is triggered when StatusInfo.sent has changed for the message. See the Message Status page.

If the message has multiple recceivers, one notification will be created for each receiver. The field notificationTriggeredByHerId will contain the Her-Id of the receiver.

MessageApprecInfoUpdated

An AppRec (application receipt) is received for a message the client has sent. The notification is triggered when StatusInfo.apprecInfo has changed for the message.

  • The field relatedMessageId will contain the Id of the original message sent by the client.
  • The field notificationReceiverHerId will contain the Her-Id of the sender of the original message (the receiver of the AppRec).
  • The field notificationTriggeredByHerId will contain the Her-Id of the receiver of the original message (the sender of the AppRec).

To get the updated apprecInfo, call the GET messages/{id}/status-endpoint with the value from relatedMessageId as id. See the Message Status page.

The raw AppRec will also appear as a NewMessage-notification.

Example Response

{
  "notifications": [
    {
      "id": "843eed10-6b56-496b-8664-ce71167c6b5c",
      "relatedMessageId": "0d5c8d05-ab57-4b2b-b480-c46c69cdf789",
      "type": "NewMessage",
      "notificationReceiverHerId": 6789,
      "notificationTriggeredByHerId": 9876,
      "description": "New message received. (EPIKRISE).",
      "createdAt": "2026-04-14T06:17:00+00:00"
    }
  ]
}

Søk i Utviklerportalen

Søket er fullført!