Skip to main content

Subscription

Trial Use 3 Foundation

The subscription resource is used to define a push-based subscription from a server to another system. Once a subscription is registered with the server, the server checks every resource that is created or updated, and if the resource matches the given criteria, it sends a message on the defined "channel" so that another system can take an appropriate action.

Endpoints​

alphahttps://api.dev.ovok.com/fhir/R4/Subscription
InteractionMethodPath
ReadGET/fhir/R4/Subscription/[id]
VreadGET/fhir/R4/Subscription/[id]/_history/[vid]
UpdatePUT/fhir/R4/Subscription/[id]
PatchPATCH/fhir/R4/Subscription/[id]
DeleteDELETE/fhir/R4/Subscription/[id]
CreatePOST/fhir/R4/Subscription
SearchGET/fhir/R4/Subscription
HistoryGET/fhir/R4/Subscription/[id]/_history

Top-level elements​

ElementType(s)CardinalityDescription
statuscode1..1requested | active | error | off modifier
contactContactPoint0..*Contact details for source (e.g. troubleshooting)
endinstant0..1When to automatically delete the subscription
reasonstring1..1Description of why this subscription was created
criteriastring1..1Rule for server push
errorstring0..1Latest error note
channelBackboneElement1..1The channel on which to report matches to the criteria

Resource-specific search parameters​

ParameterTypeDescription
_compartmentstring
_countstringhttps://www.hl7.org/fhir/search.html#_count
_elementsstringhttps://www.hl7.org/fhir/search.html#_elements
_idstring
_lastUpdatedstring
_profilestring
_securitystring
_sortstringhttps://www.hl7.org/fhir/search.html#_sort
_sourcestring
_summarystringhttps://www.hl7.org/fhir/search.html#_summary
_tagstring
_totalstringhttps://www.hl7.org/fhir/search.html#_total
authorstringhttps://medplum.com/fhir/SearchParameter/Subscription-author
contactstringhttp://hl7.org/fhir/SearchParameter/Subscription-contact
criteriastringhttp://hl7.org/fhir/SearchParameter/Subscription-criteria
payloadstringhttp://hl7.org/fhir/SearchParameter/Subscription-payload
statusstringhttp://hl7.org/fhir/SearchParameter/Subscription-status
typestringhttp://hl7.org/fhir/SearchParameter/Subscription-type
urlstringhttp://hl7.org/fhir/SearchParameter/Subscription-url

Reference​

  • Official FHIR R4 spec: Subscription
  • Maturity: Trial Use 3 (FMM 3).