Operation Definition

<?xml version="1.0" encoding="UTF-8"?>

<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="CapabilityStatement-versions"/> 
  <text> 
    

    <status value="generated"/> 
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p class="res-header-id">
        <b> Generated Narrative: OperationDefinition CapabilityStatement-versions</b> 
      </p> 
      <a name="CapabilityStatement-versions"> </a> 
      <a name="hcCapabilityStatement-versions"> </a> 
      <p> URL: [base]/$versions</p> 
      

      <h3> Parameters</h3> 
      <table class="grid">
        <tr> 
          <td> 
            <b> Use</b> 
          </td> 
          <td> 
            <b> Name</b> 
          </td> 
          <td> 
            <b> Scope</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> OUT</td> 
          <td> version</td> 
          <td/>  
          <td> 1..*</td> 
          <td> 
            <a href="datatypes.html#code">code</a> 
          </td> 
          <td/>  
          <td> 
            <div> 
              <p> A version supported by the server. Use the major.minor version like 3.0</p> 
            </div> 
          </td> 
        </tr> 
        <tr> 
          <td> OUT</td> 
          <td> default</td> 
          <td/>  
          <td> 1..1</td> 
          <td> 
            <a href="datatypes.html#code">code</a> 
          </td> 
          <td> 
            <a href="valueset-FHIR-version.html">FHIRVersion</a>  (Required)
          </td> 
          <td> 
            <div> 
              <p> The default version for the server. Use the major.minor version like 3.0</p> 
            </div> 
          </td> 
        </tr> 
      </table> 
    </div> 
  </text> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="5"/> 
  </extension> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    

    <valueCode value="normative"/> 
  </extension> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="fhir"/> 
  </extension> 
  <url value="http://hl7.org/fhir/OperationDefinition/CapabilityStatement-versions"/> 
  

  <version value="6.0.0-ballot3"/> 
  <name value="Versions"/> 
  <title value="Discover what versions a server supports"/> 
  

  <status value="active"/> 
  <kind value="operation"/> 
  <experimental value="false"/> 
  
  

  <date value="2025-11-24T20:46:00+00:00"/> 
  <publisher value="HL7 International / FHIR Infrastructure"/> 
  <contact> 
    <telecom> 
      <system value="url"/> 
      <value value="http://hl7.org/fhir"/> 
    </telecom> 
    <telecom> 
      <system value="email"/> 
      <value value="fhir@lists.hl7.org"/> 
    </telecom> 
  </contact> 
  <contact> 
    <telecom> 
      <system value="url"/> 
      <value value="http://www.hl7.org/Special/committees/fiwg"/> 
    </telecom> 
  </contact> 
  <description value="Using the [FHIR Version Mime Type Parameter](http.html#version-parameter), a server
   can support [multiple versions on the same end-point](versioning.html#mt-version).
   The only way for client to find out what versions a server supports in this fashion
   is the $versions operation. The client invokes the operation with no parameters.
   and the server returns the list of supported versions, along with the default version
   it will use if no fhirVersion parameter is present"/> 
  <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="versions"/> 
  <resource value="CapabilityStatement"/> 
  <system value="true"/> 
  <type value="false"/> 
  <instance value="false"/> 
  <parameter> 
    <name value="version"/> 
    <use value="out"/> 
    <min value="1"/> 
    <max value="*"/> 
    <documentation value="A version supported by the server. Use the major.minor version like 3.0"/> 
    <type value="code"/> 
  </parameter> 
  <parameter> 
    <name value="default"/> 
    <use value="out"/> 
    <min value="1"/> 
    <max value="1"/> 
    <documentation value="The default version for the server. Use the major.minor version like 3.0"/> 
    <type value="code"/> 
    <binding> 
      <strength value="required"/> 
      

      <valueSet value="http://hl7.org/fhir/ValueSet/FHIR-version|6.0.0-ballot3"/> 
    </binding> 
  </parameter> 


</

OperationDefinition

>