AMQPS

External consumers can subscribe to pushed specimen update notifications via AMQPS. The service publishes events to a broker hosted on the health network, in addition to over the internet in the test environment.

See the non-technical getting started page (in Norwegian) on how to get access.

Connection Details

* See environments and base URLs for host value.
** Queue name, username, and password are requested and received via a support ticket. See the non-technical getting started page (in Norwegian) on how to get access.

Note: The host is publicly accessible for the test environment. Ensure your firewall allows outbound TCP traffic on port 5671. If additional information is required to accept traffic through the firewall, contact the team on slack using the channel documented in the contact information section.

Protocol Requirements

• AMQP Version: 🚨 1.0 is enforced; clients using 0.9.1 may experience silent message drops or UUID parsing errors.
• Message Format: Events are published as JSON payloads with EventId and EventType attached.

General Payload Structure

Events will be on this format:

{
  "EventId": <uuid>,
  "EventType": <string>,
  ...other properties...
}

Property names aside from EventId and EventType depend on the value of the EventType property. You should filter by the EventType property to be compatible with future releases.

Event Types

Currently there is only one event type.

Event Type: SpecimenCollected

Indicates that a collected specimen has been submitted to the PaRek API.

Structure

{
  "EventId": <uuid>,
  "EventType": "SpecimenCollected",
  "CollectedTime": <date-time>,
  "SpecimenId": <uuid>,
  "ExternalRequisitionId": <string>,
  "ExternalDeviceId": <string>
}

Example Payload

{
  "EventId": "97ed8d92-9666-4789-9e60-e627b5ff9422",
  "EventType": "SpecimenCollected",
  "CollectedTime": "2026-04-24T14:30:00Z",
  "SpecimenId": "d084a30f-020c-43cb-823f-ed677691e00a",
  "ExternalRequisitionId": "urn:uuid:90ed4523-ff22-4aa4-adcd-5c38937c743f",
  "ExternalDeviceId": "ABC123"
}