Subscriptions R5 Backport
0.1.0 - ballot

Subscriptions R5 Backport, published by HL7 FHIR Infrastructure WG. This is not an authorized publication; it is the continuous build for version 0.1.0). This version is based on the current content of and changes regularly. See the Directory of published versions


Subscriptions are operations which typically involve three actors:

  1. Server or Publisher
  2. Client or Subscriber
  3. Endpoint

FHIR Server

Server refers to the FHIR application or applications acting as the subscription provider. This includes the responsibilities of implementing one or more SubscriptionTopics, managing Subscriptions, and sending notifications.

Note that when using subscriptions, the FHIR server combines the roles of publisher and information distributer. Some arrangements of the ‘publish and subscribe’ pattern describe separate agents for the two roles. This specification makes no recommendations towards the internal architecture of server implementations.

FHIR Client / Subscriber

Client or Subscriber refers to the application or applications acting as subscriber. This includes the responsibilites of acting as a FHIR client (to create a Subscription) and receiving notifications on a supported channel.


Endpoint refers to the portion of the client which is responsible for receiving notifications, if applicable. For example, when using the rest-hook channel type the endpoint is the HTTP server listening for notifications. While part of the client, it is often useful to refer to the endpoint separately for clarity.