This page is part of the Subscriptions R5 Backport (v1.0.0: STU 1) based on FHIR v4.3.0. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
Page standards status: Trial-use | Maturity Level: 0 |
<OperationDefinition xmlns="http://hl7.org/fhir">
<id value="backport-subscription-status"/>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml"><h2>R5SubscriptionStatus</h2><p>OPERATION: R5SubscriptionStatus</p><p>The official URL for this operation definition is: </p><pre>http://hl7.org/fhir/uv/subscriptions-backport/OperationDefinition/backport-subscription-status</pre><div><p>This operation is used to return the current status information about one or more topic-based Subscriptions in R4.</p>
</div><p>URL: [base]/Subscription/$status</p><p>URL: [base]/Subscription/[id]/$status</p><p>Parameters</p><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>id</td><td>0..*</td><td><a href="http://hl7.org/fhir/R4B/datatypes.html#id">id</a></td><td/><td><div><p>At the Instance level, this parameter is ignored. At the Resource level, one or more parameters containing a FHIR id for a Subscription to get status information for. In the absence of any specified ids, the server returns the status for all Subscriptions available to the caller. Multiple values are joined via OR (e.g., "id1" OR "id2").</p>
</div></td></tr><tr><td>IN</td><td>status</td><td>0..*</td><td><a href="http://hl7.org/fhir/R4B/datatypes.html#code">code</a></td><td/><td><div><p>At the Instance level, this parameter is ignored. At the Resource level, a Subscription status to filter by (e.g., "active"). In the absence of any specified status values, the server does not filter contents based on the status. Multiple values are joined via OR (e.g., "error" OR "off").</p>
</div></td></tr><tr><td>OUT</td><td>return</td><td>1..1</td><td><a href="http://hl7.org/fhir/R4B/bundle.html">Bundle</a></td><td/><td><div><p>The operation returns a bundle containing one or more SubscriptionStatus resources, one per Subscription being queried. The Bundle type is "searchset".</p>
</div></td></tr></table></div>
</text>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
<valueInteger value="0"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
<valueCode value="trial-use"/>
</extension>
<url
value="http://hl7.org/fhir/uv/subscriptions-backport/OperationDefinition/backport-subscription-status"/>
<version value="1.0.0"/>
<name value="R5SubscriptionStatus"/>
<status value="active"/>
<kind value="operation"/>
<date value="2020-11-30"/>
<publisher value="HL7 FHIR Infrastructure WG"/>
<contact>
<name value="HL7 FHIR Infrastructure WG"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org/Special/committees/fiwg"/>
</telecom>
</contact>
<contact>
<name value="HL7 FHIR Infrastructure WG"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org/Special/committees/fiwg"/>
</telecom>
</contact>
<contact>
<name value="Gino Canessa"/>
<telecom>
<system value="email"/>
<value value="mailto:gino.canessa@microsoft.com"/>
</telecom>
</contact>
<contact>
<name value="Eric Haas"/>
<telecom>
<system value="email"/>
<value value="mailto:ehaas@healthedatainc.com"/>
</telecom>
</contact>
<description
value="This operation is used to return the current status information about one or more topic-based Subscriptions in R4."/>
<jurisdiction>
<coding>
<system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
<code value="001"/>
<display value="World"/>
</coding>
</jurisdiction>
<affectsState value="false"/>
<code value="status"/>
<resource value="Subscription"/>
<system value="false"/>
<type value="true"/>
<instance value="true"/>
<parameter>
<name value="id"/>
<use value="in"/>
<min value="0"/>
<max value="*"/>
<documentation
value="At the Instance level, this parameter is ignored. At the Resource level, one or more parameters containing a FHIR id for a Subscription to get status information for. In the absence of any specified ids, the server returns the status for all Subscriptions available to the caller. Multiple values are joined via OR (e.g., "id1" OR "id2")."/>
<type value="id"/>
</parameter>
<parameter>
<name value="status"/>
<use value="in"/>
<min value="0"/>
<max value="*"/>
<documentation
value="At the Instance level, this parameter is ignored. At the Resource level, a Subscription status to filter by (e.g., "active"). In the absence of any specified status values, the server does not filter contents based on the status. Multiple values are joined via OR (e.g., "error" OR "off")."/>
<type value="code"/>
</parameter>
<parameter>
<name value="return"/>
<use value="out"/>
<min value="1"/>
<max value="1"/>
<documentation
value="The operation returns a bundle containing one or more SubscriptionStatus resources, one per Subscription being queried. The Bundle type is "searchset"."/>
<type value="Bundle"/>
</parameter>
</OperationDefinition>