This page is part of the FHIR Specification (v5.0.0: R5 - STU). This is the current published version in it's permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3

5.3 Resource CapabilityStatement - Content

FHIR Infrastructure icon

Work Group

Maturity Level: N

Normative (from v4.0.0)

Security Category: Anonymous

Compartments: No defined compartments

A Capability Statement documents a set of capabilities (behaviors) of a FHIR Server or Client for a particular version of FHIR that may be used as a statement of actual server functionality or a statement of required or desired server implementation.

5.3.1 Scope and Usage

The capability statement is a key part of the overall conformance framework in FHIR. It is used as a statement of the features of actual software, or of a set of rules for an application to provide. This statement connects to all the detailed statements of functionality, such as StructureDefinitions and ValueSets. This composite statement of application capability may be used for system compatibility testing, code generation, or as the basis for a conformance assessment. For further information about Conformance testing, see Conformance Rules and Profiling FHIR.

Specifically, capability statements are used in one of three ways:

Instance implementation must be present and software may be present

Capability implementation must be absent, software must be present

Requirements implementation and software must be absent

5.3.1.1 Instance: Describe an actual implementation

In this scenario, the capability statement describes the capabilities of a deployed and configured solution available at a particular access point or set of access points. The statement describes exactly how to interface with that deployed solution and thus provides for a degree of self-configuration of software solutions.

This is the type of statement that FHIR restful solutions are expected to make available on invocation of the capabilities operation. It is also the type of statement that forms a basis for the testing, certification or commissioning of specific software installations.

5.3.1.2 Capability: Describe software solution capabilities

In this scenario, the capability statement describes generic capabilities of a software application or component solution. The solution might be available for purchase or other acquisition and might be deployed and configured at any number of independent sites. Because it is not dependent on any particular implementation, the profile cannot provide specific details such as endpoint addresses. It may also need to document various configurations in which the application can be set up or describe the degree of customizability associated with the solution.

This type of statement may be used as a marketing tool by software and system developers to formally describe their capabilities. It can also be used as the basis for conformance testing of software solutions independent of a particular installation.

5.3.1.3 Requirements: Describe a desired solution

In this scenario, the capability statement describes the capabilities of a desired system. It might be used as part of an architectural design process to document needed system capabilities, or might be used as part of an RFP process to formally document the requirements of a requested solution and to document the criteria by which proposals will be evaluated.

These three types of profiles can be used together. A requirements statement can be compared against the solution statements proffered by respondents to an RFP. A solution statement for a software package forms the starting point for the implementation statement associated with a particular installation of that software package.

CapabilityStatements of type "requirement" describe what capabilities are potentially relevant; additional documentation or extensions (see capabilitystatement-expectation) within the CapabilityStatement are expected to make more explicit statements of degree of expectation associated with each capability.

5.3.2 Background and Context

Capability Statements provide for a degree of automatic configuration and adaptation. However, capturing absolutely every variation that could impact the interoperability of two systems, let alone keeping that detailed information up-to-date as systems evolve through maintenance and upgrades, is rarely practical. Therefore, capability statements should be seen as an interim step. They provide a degree of automation. However, they also provide a great deal of human-readable content that can minimize the need for direct communication between the operators of the systems being configured to interoperate.

5.3.2.1 Supporting Multiple Versions

Applications may implement multiple versions. If they do, then a CapabilityStatement describes the system's support for a particular version of FHIR, and the system will have multiple statements, one for each version it supports. For further information, see Managing Multiple Versions, and the $versions operation.

5.3.2.2 Mixed Normative Content

While the core of the CapabilityStatement resource is Normative, many of the flags that indicate exactly how the system operates are marked as trial-use. Roughly, the portions of the resource that correspond to OpenAPI document icon elements are normative.

Applications looking for normative stability should only use the normative parts of the resource, and not populate or ignore the portions labelled trial-use. To assist with this, clients can ask for the server to return a 'Normative content only' CapabilityStatement using the mode parameter on /metadata.

Community discussion regarding more capable, efficient and computable representations of an applications capabilities may lead to change to the trial-use parts of this resource or the creation of new resources and/or functionality in future versions of this specification.

5.3.3 References to this Resource

Resource References: ActivityDefinition, ActorDefinition, itself, PlanDefinition, RequestOrchestration and TestScript

Structure

Description & Constraints

CapabilityStatement

DomainResource

A statement of system capabilities
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: A Capability Statement SHALL have at least one of REST, messaging or document element.
+ Rule: A Capability Statement SHALL have at least one of description, software, or implementation element.
+ Rule: Messaging end-point is only permitted when a capability statement is for an implementation.
+ Rule: There should only be one CapabilityStatement.rest per mode.
+ Rule: The set of documents must be unique by the combination of profile and mode.
+ Rule: If kind = instance, implementation must be present and software may be present
+ Rule: If kind = capability, implementation must be absent, software must be present
+ Rule: If kind = requirements, implementation and software must be absent

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
Interfaces Implemented: CanonicalResource

url

Σ C

0..1

uri

Canonical identifier for this capability statement, represented as a URI (globally unique)
+ Warning: URL should not contain | or # - these characters make processing canonical references problematic

identifier

Σ TU

0..*

Identifier

Additional identifier for the CapabilityStatement (business identifier)

version

0..1

string

Business version of the capability statement

versionAlgorithm[x]

Σ TU

0..1

How to compare versions
Binding: Version Algorithm (Extensible)

versionAlgorithmString

string

versionAlgorithmCoding

Coding

name

Σ C

0..1

string

Name for this capability statement (computer friendly)

title

Σ T

0..1

string

Name for this capability statement (human friendly)

status

?!Σ

1..1

code

draft | active | retired | unknown
Binding: PublicationStatus (Required)

experimental

0..1

boolean

For testing purposes, not real usage

date

1..1

dateTime

Date last changed

publisher

Σ T

0..1

string

Name of the publisher/steward (organization or individual)

contact

0..*

ContactDetail

Contact details for the publisher

description

T C

0..1

markdown

Natural language description of the capability statement

useContext

Σ TU

0..*

UsageContext

The context that the content is intended to support

jurisdiction

Σ XD

0..*

CodeableConcept

Intended jurisdiction for capability statement (if applicable)
Binding: Jurisdiction ValueSet (Extensible)

purpose

0..1

markdown

Why this capability statement is defined

0..1

markdown

Use and/or publishing restrictions

copyrightLabel

T TU

0..1

string

kind

Σ C

1..1

code

instance | capability | requirements
Binding: Capability Statement Kind (Required)

instantiates

0..*

canonical(CapabilityStatement)

Canonical URL of another capability statement this implements

imports

Σ TU

0..*

canonical(CapabilityStatement)

Canonical URL of another capability statement this adds to

software

Σ C

0..1

BackboneElement

Software that is covered by this capability statement

name

1..1

string

A name the software is known by

version

0..1

string

Version covered by this statement

releaseDate

0..1

dateTime

Date this version was released

implementation

Σ C

0..1

BackboneElement

If this describes a specific instance

description

1..1

markdown

Describes this specific instance

url

0..1

url

Base URL for the installation

custodian

Σ TU

0..1

Reference(Organization)

Organization that manages the data

fhirVersion

1..1

code

FHIR Version the system supports
Binding: FHIRVersion (Required)

format

1..*

code

formats supported (xml | json | ttl | mime type)
Binding: Mime Types (Required)

Additional Bindings

Purpose

Capability Format Type

Starter Set

patchFormat

0..*

code

Patch formats supported
Binding: Mime Types (Required)

acceptLanguage

Σ TU

0..*

code

Languages supported
Binding: All Languages (Required)

Additional Bindings

Purpose

Common Languages

Starter Set

implementationGuide

0..*

canonical(ImplementationGuide)

Implementation guides supported

rest

Σ C

0..*

BackboneElement

If the endpoint is a RESTful one
+ Rule: A given resource can only be described once per RESTful mode.

mode

Σ C

1..1

code

client | server
Binding: Restful Capability Mode (Required)

documentation

0..1

markdown

General description of implementation

security

Σ TU

0..1

BackboneElement

Information about security of implementation

cors

0..1

boolean

Adds CORS Headers (http://enable-cors.org/)

0..*

0..1

General description of how security works

resource

Σ C

0..*

BackboneElement

Resource served on the REST interface
+ Rule: Search parameter names must be unique in the context of a resource.

type

Σ C

1..1

code

A resource type that is supported
Binding: Resource Types (Required)

profile

0..1

canonical(StructureDefinition)

System-wide profile

supportedProfile

Σ TU

0..*

canonical(StructureDefinition)

Use-case specific profiles

documentation

0..1

markdown

Additional information about the use of the resource type

interaction

0..*

BackboneElement

What operations are supported?

code

1..1

code

documentation

0..1

markdown

Anything special about operation behavior

versioning

0..1

code

no-version | versioned | versioned-update
Binding: Resource Version Policy (Required)

readHistory

0..1

boolean

Whether vRead can return past versions

updateCreate

0..1

boolean

If update can commit to a new identity

conditionalCreate

0..1

boolean

If allows/uses conditional create

conditionalRead

0..1

code

not-supported | modified-since | not-match | full-support
Binding: Conditional Read Status (Required)

conditionalUpdate

0..1

boolean

If allows/uses conditional update

conditionalPatch

0..1

boolean

If allows/uses conditional patch

conditionalDelete

0..1

code

not-supported | single | multiple - how conditional delete is supported
Binding: Conditional Delete Status (Required)

referencePolicy

0..*

code

literal | logical | resolves | enforced | local
Binding: Reference Handling Policy (Required)

searchInclude

0..*

string

_include values supported by the server

searchRevInclude

0..*

string

_revinclude values supported by the server

searchParam

0..*

BackboneElement

Search parameters supported by implementation

name

1..1

string

Name for parameter in search url

definition

0..1

canonical(SearchParameter)

Source of definition for parameter

type

1..1

code

documentation

0..1

markdown

Server-specific usage

operation

0..*

BackboneElement

Definition of a resource operation

name

1..1

string

Name by which the operation/query is invoked

definition

1..1

canonical(OperationDefinition)

The defined operation/query

documentation

0..1

markdown

Specific details about operation behavior

interaction

0..*

BackboneElement

What operations are supported?

code

1..1

code

transaction | batch | search-system | history-system
Binding: System Restful Interaction (Required)

documentation

0..1

markdown

Anything special about operation behavior

searchParam

0..*

see searchParam

Search parameters for searching all resources

operation

0..*

see operation

Definition of a system level operation

compartment

0..*

canonical(CompartmentDefinition)

Compartments served/used by system

messaging

Σ C TU

0..*

BackboneElement

If messaging is supported

endpoint

0..*

BackboneElement

Where messages should be sent

protocol

1..1

Coding

http | ftp | mllp +
Binding: Message Transport (Extensible)

address

1..1

url

Network address or identifier of the end-point

reliableCache

0..1

unsignedInt

Reliable Message Cache Length (min)

documentation

0..1

markdown

Messaging interface behavior details

supportedMessage

0..*

BackboneElement

Messages supported by this system

mode

1..1

code

sender | receiver
Binding: Event Capability Mode (Required)

definition

1..1

canonical(MessageDefinition)

Message supported by this system

document

Σ C TU

0..*

BackboneElement

Document definition

mode

Σ C

1..1

code

producer | consumer
Binding: Document Mode (Required)

documentation

0..1

markdown

Description of document support

profile

Σ C

1..1

canonical(StructureDefinition)

Constraint on the resources used in the document

Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<CapabilityStatement xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this capability statement, represented as a URI (globally unique) -->
 <identifier><!-- 0..* Identifier Additional identifier for the CapabilityStatement (business identifier) --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the capability statement -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this capability statement (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this capability statement (human friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 1..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- I 0..1 Natural language description of the capability statement -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for capability statement (if applicable) --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this capability statement is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) -->
 <kind value="[code]"/><!-- I 1..1 instance | capability | requirements -->
 <instantiates><!-- 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this implements --></instantiates>
 <imports><!-- 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this adds to --></imports>
 <software>  <!-- I 0..1 Software that is covered by this capability statement -->
  <name value="[string]"/><!-- 1..1 A name the software is known by -->
  <version value="[string]"/><!-- 0..1 Version covered by this statement -->
  <releaseDate value="[dateTime]"/><!-- 0..1 Date this version was released -->
 </software>
 <implementation>  <!-- I 0..1 If this describes a specific instance -->
  <description value="[markdown]"/><!-- 1..1 Describes this specific instance -->
  <url value="[url]"/><!-- 0..1 Base URL for the installation -->
  <custodian><!-- 0..1 Reference(Organization) Organization that manages the data --></custodian>
 </implementation>
 <fhirVersion value="[code]"/><!-- 1..1 FHIR Version the system supports -->
 <format value="[code]"/><!-- 1..* formats supported (xml | json | ttl | mime type) -->
 <patchFormat value="[code]"/><!-- 0..* Patch formats supported -->
 <acceptLanguage value="[code]"/><!-- 0..* Languages supported -->
 <implementationGuide><!-- 0..* canonical(ImplementationGuide) Implementation guides supported --></implementationGuide>
 <rest>  <!-- I 0..* If the endpoint is a RESTful one -->
  <mode value="[code]"/><!-- I 1..1 client | server -->
  <documentation value="[markdown]"/><!-- 0..1 General description of implementation -->
  <security>  <!-- 0..1 Information about security of implementation -->
   <cors value="[boolean]"/><!-- 0..1 Adds CORS Headers (http://enable-cors.org/) -->
   <service><!-- 0..* CodeableConcept OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates --></service>
   <description value="[markdown]"/><!-- 0..1 General description of how security works -->
  </security>
  <resource>  <!-- I 0..* Resource served on the REST interface -->
   <type value="[code]"/><!-- I 1..1 A resource type that is supported -->
   <profile><!-- 0..1 canonical(StructureDefinition) System-wide profile --></profile>
   <supportedProfile><!-- 0..* canonical(StructureDefinition) Use-case specific profiles --></supportedProfile>
   <documentation value="[markdown]"/><!-- 0..1 Additional information about the use of the resource type -->
   <interaction>  <!-- 0..* What operations are supported? -->
    <code value="[code]"/><!-- 1..1 read | vread | update | patch | delete | history-instance | history-type | create | search-type -->
    <documentation value="[markdown]"/><!-- 0..1 Anything special about operation behavior -->
   </interaction>
   <versioning value="[code]"/><!-- 0..1 no-version | versioned | versioned-update -->
   <readHistory value="[boolean]"/><!-- 0..1 Whether vRead can return past versions -->
   <updateCreate value="[boolean]"/><!-- 0..1 If update can commit to a new identity -->
   <conditionalCreate value="[boolean]"/><!-- 0..1 If allows/uses conditional create -->
   <conditionalRead value="[code]"/><!-- 0..1 not-supported | modified-since | not-match | full-support -->
   <conditionalUpdate value="[boolean]"/><!-- 0..1 If allows/uses conditional update -->
   <conditionalPatch value="[boolean]"/><!-- 0..1 If allows/uses conditional patch -->
   <conditionalDelete value="[code]"/><!-- 0..1 not-supported | single | multiple - how conditional delete is supported -->
   <referencePolicy value="[code]"/><!-- 0..* literal | logical | resolves | enforced | local -->
   <searchInclude value="[string]"/><!-- 0..* _include values supported by the server -->
   <searchRevInclude value="[string]"/><!-- 0..* _revinclude values supported by the server -->
   <searchParam>  <!-- I 0..* Search parameters supported by implementation -->
    <name value="[string]"/><!-- I 1..1 Name for parameter in search url -->
    <definition><!-- 0..1 canonical(SearchParameter) Source of definition for parameter --></definition>
    <type value="[code]"/><!-- 1..1 number | date | string | token | reference | composite | quantity | uri | special -->
    <documentation value="[markdown]"/><!-- 0..1 Server-specific usage -->
   </searchParam>
   <operation>  <!-- 0..* Definition of a resource operation -->
    <name value="[string]"/><!-- 1..1 Name by which the operation/query is invoked -->
    <definition><!-- 1..1 canonical(OperationDefinition) The defined operation/query --></definition>
    <documentation value="[markdown]"/><!-- 0..1 Specific details about operation behavior -->
   </operation>
  </resource>
  <interaction>  <!-- 0..* What operations are supported? -->
   <code value="[code]"/><!-- 1..1 transaction | batch | search-system | history-system -->
   <documentation value="[markdown]"/><!-- 0..1 Anything special about operation behavior -->
  </interaction>
  <searchParam><!-- 0..* Content as for CapabilityStatement.rest.resource.searchParam Search parameters for searching all resources --></searchParam>
  <operation><!-- 0..* Content as for CapabilityStatement.rest.resource.operation Definition of a system level operation --></operation>
  <compartment><!-- 0..* canonical(CompartmentDefinition) Compartments served/used by system --></compartment>
 </rest>
 <messaging>  <!-- I 0..* If messaging is supported -->
  <endpoint>  <!-- I 0..* Where messages should be sent -->
   <protocol><!-- 1..1 Coding http | ftp | mllp + --></protocol>
   <address value="[url]"/><!-- 1..1 Network address or identifier of the end-point -->
  </endpoint>
  <reliableCache value="[unsignedInt]"/><!-- 0..1 Reliable Message Cache Length (min) -->
  <documentation value="[markdown]"/><!-- 0..1 Messaging interface behavior details -->
  <supportedMessage>  <!-- 0..* Messages supported by this system -->
   <mode value="[code]"/><!-- 1..1 sender | receiver -->
   <definition><!-- 1..1 canonical(MessageDefinition) Message supported by this system --></definition>
  </supportedMessage>
 </messaging>
 <document>  <!-- I 0..* Document definition -->
  <mode value="[code]"/><!-- I 1..1 producer | consumer -->
  <documentation value="[markdown]"/><!-- 0..1 Description of document support -->
  <profile><!-- I 1..1 canonical(StructureDefinition) Constraint on the resources used in the document --></profile>
 </document>
</CapabilityStatement>

JSON Template

{
  "resourceType" : "CapabilityStatement",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Canonical identifier for this capability statement, represented as a URI (globally unique)
  "identifier" : [{ Identifier }], // Additional identifier for the CapabilityStatement (business identifier)
  "version" : "<string>", // Business version of the capability statement
  // versionAlgorithm[x]: How to compare versions. One of these 2:
  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this capability statement (computer friendly)
  "title" : "<string>", // Name for this capability statement (human friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // R!  Date last changed
  "publisher" : "<string>", // Name of the publisher/steward (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // I Natural language description of the capability statement
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for capability statement (if applicable)
  "purpose" : "<markdown>", // Why this capability statement is defined
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "copyrightLabel" : "<string>", // Copyright holder and year(s)
  "kind" : "<code>", // I R!  instance | capability | requirements
  "instantiates" : ["<canonical(CapabilityStatement)>"], // Canonical URL of another capability statement this implements
  "imports" : ["<canonical(CapabilityStatement)>"], // Canonical URL of another capability statement this adds to
  "software" : { // I Software that is covered by this capability statement
    "name" : "<string>", // R!  A name the software is known by
    "version" : "<string>", // Version covered by this statement
    "releaseDate" : "<dateTime>" // Date this version was released
  },
  "implementation" : { // I If this describes a specific instance
    "description" : "<markdown>", // R!  Describes this specific instance
    "url" : "<url>", // Base URL for the installation
    "custodian" : { Reference(Organization) } // Organization that manages the data
  },
  "fhirVersion" : "<code>", // R!  FHIR Version the system supports
  "format" : ["<code>"], // R!  formats supported (xml | json | ttl | mime type)
  "patchFormat" : ["<code>"], // Patch formats supported
  "acceptLanguage" : ["<code>"], // Languages supported
  "implementationGuide" : ["<canonical(ImplementationGuide)>"], // Implementation guides supported
  "rest" : [{ // I If the endpoint is a RESTful one
    "mode" : "<code>", // I R!  client | server
    "documentation" : "<markdown>", // General description of implementation
    "security" : { // Information about security of implementation
      "cors" : <boolean>, // Adds CORS Headers (http://enable-cors.org/)
      "service" : [{ CodeableConcept }], // OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
      "description" : "<markdown>" // General description of how security works
    },
    "resource" : [{ // I Resource served on the REST interface
      "type" : "<code>", // I R!  A resource type that is supported
      "profile" : "<canonical(StructureDefinition)>", // System-wide profile
      "supportedProfile" : ["<canonical(StructureDefinition)>"], // Use-case specific profiles
      "documentation" : "<markdown>", // Additional information about the use of the resource type
      "interaction" : [{ // What operations are supported?
        "code" : "<code>", // R!  read | vread | update | patch | delete | history-instance | history-type | create | search-type
        "documentation" : "<markdown>" // Anything special about operation behavior
      }],
      "versioning" : "<code>", // no-version | versioned | versioned-update
      "readHistory" : <boolean>, // Whether vRead can return past versions
      "updateCreate" : <boolean>, // If update can commit to a new identity
      "conditionalCreate" : <boolean>, // If allows/uses conditional create
      "conditionalRead" : "<code>", // not-supported | modified-since | not-match | full-support
      "conditionalUpdate" : <boolean>, // If allows/uses conditional update
      "conditionalPatch" : <boolean>, // If allows/uses conditional patch
      "conditionalDelete" : "<code>", // not-supported | single | multiple - how conditional delete is supported
      "referencePolicy" : ["<code>"], // literal | logical | resolves | enforced | local
      "searchInclude" : ["<string>"], // _include values supported by the server
      "searchRevInclude" : ["<string>"], // _revinclude values supported by the server
      "searchParam" : [{ // I Search parameters supported by implementation
        "name" : "<string>", // I R!  Name for parameter in search url
        "definition" : "<canonical(SearchParameter)>", // Source of definition for parameter
        "type" : "<code>", // R!  number | date | string | token | reference | composite | quantity | uri | special
        "documentation" : "<markdown>" // Server-specific usage
      }],
      "operation" : [{ // Definition of a resource operation
        "name" : "<string>", // R!  Name by which the operation/query is invoked
        "definition" : "<canonical(OperationDefinition)>", // R!  The defined operation/query
        "documentation" : "<markdown>" // Specific details about operation behavior
      }]
    }],
    "interaction" : [{ // What operations are supported?
      "code" : "<code>", // R!  transaction | batch | search-system | history-system
      "documentation" : "<markdown>" // Anything special about operation behavior
    }],
    "searchParam" : [{ Content as for CapabilityStatement.rest.resource.searchParam }], // Search parameters for searching all resources
    "operation" : [{ Content as for CapabilityStatement.rest.resource.operation }], // Definition of a system level operation
    "compartment" : ["<canonical(CompartmentDefinition)>"] // Compartments served/used by system
  }],
  "messaging" : [{ // I If messaging is supported
    "endpoint" : [{ // I Where messages should be sent
      "protocol" : { Coding }, // R!  http | ftp | mllp +
      "address" : "<url>" // R!  Network address or identifier of the end-point
    }],
    "reliableCache" : "<unsignedInt>", // Reliable Message Cache Length (min)
    "documentation" : "<markdown>", // Messaging interface behavior details
    "supportedMessage" : [{ // Messages supported by this system
      "mode" : "<code>", // R!  sender | receiver
      "definition" : "<canonical(MessageDefinition)>" // R!  Message supported by this system
    }]
  }],
  "document" : [{ // I Document definition
    "mode" : "<code>", // I R!  producer | consumer
    "documentation" : "<markdown>", // Description of document support
    "profile" : "<canonical(StructureDefinition)>" // I R!  Constraint on the resources used in the document
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:CapabilityStatement;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:url [ uri ] ; # 0..1 Canonical identifier for this capability statement, represented as a URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Additional identifier for the CapabilityStatement (business identifier)
  fhir:version [ string ] ; # 0..1 Business version of the capability statement
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:string ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this capability statement (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this capability statement (human friendly)
  fhir:status [ code ] ; # 1..1 draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 For testing purposes, not real usage
  fhir:date [ dateTime ] ; # 1..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual)
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 I Natural language description of the capability statement
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for capability statement (if applicable)
  fhir:purpose [ markdown ] ; # 0..1 Why this capability statement is defined
  fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions
  fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s)
  fhir:kind [ code ] ; # 1..1 I instance | capability | requirements
  fhir:instantiates  ( [ canonical(CapabilityStatement) ] ... ) ; # 0..* Canonical URL of another capability statement this implements
  fhir:imports  ( [ canonical(CapabilityStatement) ] ... ) ; # 0..* Canonical URL of another capability statement this adds to
  fhir:software [ # 0..1 I Software that is covered by this capability statement
    fhir:name [ string ] ; # 1..1 A name the software is known by
    fhir:version [ string ] ; # 0..1 Version covered by this statement
    fhir:releaseDate [ dateTime ] ; # 0..1 Date this version was released
  ] ;
  fhir:implementation [ # 0..1 I If this describes a specific instance
    fhir:description [ markdown ] ; # 1..1 Describes this specific instance
    fhir:url [ url ] ; # 0..1 Base URL for the installation
    fhir:custodian [ Reference(Organization) ] ; # 0..1 Organization that manages the data
  ] ;
  fhir:fhirVersion [ code ] ; # 1..1 FHIR Version the system supports
  fhir:format  ( [ code ] ... ) ; # 1..* formats supported (xml | json | ttl | mime type)
  fhir:patchFormat  ( [ code ] ... ) ; # 0..* Patch formats supported
  fhir:acceptLanguage  ( [ code ] ... ) ; # 0..* Languages supported
  fhir:implementationGuide  ( [ canonical(ImplementationGuide) ] ... ) ; # 0..* Implementation guides supported
  fhir:rest ( [ # 0..* I If the endpoint is a RESTful one
    fhir:mode [ code ] ; # 1..1 I client | server
    fhir:documentation [ markdown ] ; # 0..1 General description of implementation
    fhir:security [ # 0..1 Information about security of implementation
      fhir:cors [ boolean ] ; # 0..1 Adds CORS Headers (http://enable-cors.org/)
      fhir:service  ( [ CodeableConcept ] ... ) ; # 0..* OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
      fhir:description [ markdown ] ; # 0..1 General description of how security works
    ] ;
    fhir:resource ( [ # 0..* I Resource served on the REST interface
      fhir:type [ code ] ; # 1..1 I A resource type that is supported
      fhir:profile [ canonical(StructureDefinition) ] ; # 0..1 System-wide profile
      fhir:supportedProfile  ( [ canonical(StructureDefinition) ] ... ) ; # 0..* Use-case specific profiles
      fhir:documentation [ markdown ] ; # 0..1 Additional information about the use of the resource type
      fhir:interaction ( [ # 0..* What operations are supported?
        fhir:code [ code ] ; # 1..1 read | vread | update | patch | delete | history-instance | history-type | create | search-type
        fhir:documentation [ markdown ] ; # 0..1 Anything special about operation behavior
      ] ... ) ;
      fhir:versioning [ code ] ; # 0..1 no-version | versioned | versioned-update
      fhir:readHistory [ boolean ] ; # 0..1 Whether vRead can return past versions
      fhir:updateCreate [ boolean ] ; # 0..1 If update can commit to a new identity
      fhir:conditionalCreate [ boolean ] ; # 0..1 If allows/uses conditional create
      fhir:conditionalRead [ code ] ; # 0..1 not-supported | modified-since | not-match | full-support
      fhir:conditionalUpdate [ boolean ] ; # 0..1 If allows/uses conditional update
      fhir:conditionalPatch [ boolean ] ; # 0..1 If allows/uses conditional patch
      fhir:conditionalDelete [ code ] ; # 0..1 not-supported | single | multiple - how conditional delete is supported
      fhir:referencePolicy  ( [ code ] ... ) ; # 0..* literal | logical | resolves | enforced | local
      fhir:searchInclude  ( [ string ] ... ) ; # 0..* _include values supported by the server
      fhir:searchRevInclude  ( [ string ] ... ) ; # 0..* _revinclude values supported by the server
      fhir:searchParam ( [ # 0..* I Search parameters supported by implementation
        fhir:name [ string ] ; # 1..1 I Name for parameter in search url
        fhir:definition [ canonical(SearchParameter) ] ; # 0..1 Source of definition for parameter
        fhir:type [ code ] ; # 1..1 number | date | string | token | reference | composite | quantity | uri | special
        fhir:documentation [ markdown ] ; # 0..1 Server-specific usage
      ] ... ) ;
      fhir:operation ( [ # 0..* Definition of a resource operation
        fhir:name [ string ] ; # 1..1 Name by which the operation/query is invoked
        fhir:definition [ canonical(OperationDefinition) ] ; # 1..1 The defined operation/query
        fhir:documentation [ markdown ] ; # 0..1 Specific details about operation behavior
      ] ... ) ;
    ] ... ) ;
    fhir:interaction ( [ # 0..* What operations are supported?
      fhir:code [ code ] ; # 1..1 transaction | batch | search-system | history-system
      fhir:documentation [ markdown ] ; # 0..1 Anything special about operation behavior
    ] ... ) ;
    fhir:searchParam  ( [ See CapabilityStatement.rest.resource.searchParam ] ... ) ; # 0..* Search parameters for searching all resources
    fhir:operation  ( [ See CapabilityStatement.rest.resource.operation ] ... ) ; # 0..* Definition of a system level operation
    fhir:compartment  ( [ canonical(CompartmentDefinition) ] ... ) ; # 0..* Compartments served/used by system
  ] ... ) ;
  fhir:messaging ( [ # 0..* I If messaging is supported
    fhir:endpoint ( [ # 0..* I Where messages should be sent
      fhir:protocol [ Coding ] ; # 1..1 http | ftp | mllp +
      fhir:address [ url ] ; # 1..1 Network address or identifier of the end-point
    ] ... ) ;
    fhir:reliableCache [ unsignedInt ] ; # 0..1 Reliable Message Cache Length (min)
    fhir:documentation [ markdown ] ; # 0..1 Messaging interface behavior details
    fhir:supportedMessage ( [ # 0..* Messages supported by this system
      fhir:mode [ code ] ; # 1..1 sender | receiver
      fhir:definition [ canonical(MessageDefinition) ] ; # 1..1 Message supported by this system
    ] ... ) ;
  ] ... ) ;
  fhir:document ( [ # 0..* I Document definition
    fhir:mode [ code ] ; # 1..1 I producer | consumer
    fhir:documentation [ markdown ] ; # 0..1 Description of document support
    fhir:profile [ canonical(StructureDefinition) ] ; # 1..1 I Constraint on the resources used in the document
  ] ... ) ;
]

Changes from R4 and R4B

CapabilityStatement

CapabilityStatement.identifier

Added Element

CapabilityStatement.versionAlgorithm[x]

Added Element

CapabilityStatement.copyrightLabel

Added Element

CapabilityStatement.implementation.description

Type changed from string to markdown

CapabilityStatement.fhirVersion

Add codes 0.0, 0.4, 0.5, 1.0, 1.1, 1.4, 1.6, 1.8, 3.0, 3.0.2, 3.3, 3.5, 4.0, 4.0.1, 4.1, 4.1.0, 4.2, 4.2.0, 4.3, 4.3.0, 4.3.0-cibuild, 4.3.0-snapshot1, 4.4, 4.4.0, 4.5, 4.5.0, 4.6, 4.6.0, 5.0, 5.0.0, 5.0.0-cibuild, 5.0.0-snapshot1, 5.0.0-snapshot2, 5.0.0-ballot, 5.0.0-snapshot3, 5.0.0-draft-final

CapabilityStatement.acceptLanguage

Added Element

CapabilityStatement.rest.security.service

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/restful-security-service" to "http://hl7.org/fhir/restful-security-service"

CapabilityStatement.rest.resource.type

Remove codes CatalogEntry, DeviceUseStatement, DocumentManifest, DomainResource, EffectEvidenceSynthesis, Media, MedicinalProduct, MedicinalProductAuthorization, MedicinalProductContraindication, MedicinalProductIndication, MedicinalProductIngredient, MedicinalProductInteraction, MedicinalProductManufactured, MedicinalProductPackaged, MedicinalProductPharmaceutical, MedicinalProductUndesirableEffect, RequestGroup, ResearchDefinition, ResearchElementDefinition, Resource, RiskEvidenceSynthesis, SubstanceSpecification
Add codes ActorDefinition, AdministrableProductDefinition, ArtifactAssessment, BiologicallyDerivedProductDispense, Citation, ClinicalUseDefinition, ConditionDefinition, DeviceAssociation, DeviceDispense, DeviceUsage, EncounterHistory, EvidenceReport, FormularyItem, GenomicStudy, ImagingSelection, Ingredient, InventoryItem, InventoryReport, ManufacturedItemDefinition, MedicinalProductDefinition, NutritionIntake, NutritionProduct, PackagedProductDefinition, Permission, RegulatedAuthorization, RequestOrchestration, Requirements, SubscriptionStatus, SubscriptionTopic, SubstanceDefinition, TestPlan, Transport

CapabilityStatement.rest.resource.conditionalPatch

Added Element

CapabilityStatement.messaging.endpoint.protocol

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/message-transport" to "http://hl7.org/fhir/message-transport"

Changes from R4 and R4B

CapabilityStatement

CapabilityStatement.identifier

Added Element

CapabilityStatement.versionAlgorithm[x]

Added Element

CapabilityStatement.copyrightLabel

Added Element

CapabilityStatement.implementation.description

Type changed from string to markdown

CapabilityStatement.fhirVersion

Add codes 0.0, 0.4, 0.5, 1.0, 1.1, 1.4, 1.6, 1.8, 3.0, 3.0.2, 3.3, 3.5, 4.0, 4.0.1, 4.1, 4.1.0, 4.2, 4.2.0, 4.3, 4.3.0, 4.3.0-cibuild, 4.3.0-snapshot1, 4.4, 4.4.0, 4.5, 4.5.0, 4.6, 4.6.0, 5.0, 5.0.0, 5.0.0-cibuild, 5.0.0-snapshot1, 5.0.0-snapshot2, 5.0.0-ballot, 5.0.0-snapshot3, 5.0.0-draft-final

CapabilityStatement.acceptLanguage

Added Element

CapabilityStatement.rest.security.service

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/restful-security-service" to "http://hl7.org/fhir/restful-security-service"

CapabilityStatement.rest.resource.type

Remove codes CatalogEntry, DeviceUseStatement, DocumentManifest, DomainResource, EffectEvidenceSynthesis, Media, MedicinalProduct, MedicinalProductAuthorization, MedicinalProductContraindication, MedicinalProductIndication, MedicinalProductIngredient, MedicinalProductInteraction, MedicinalProductManufactured, MedicinalProductPackaged, MedicinalProductPharmaceutical, MedicinalProductUndesirableEffect, RequestGroup, ResearchDefinition, ResearchElementDefinition, Resource, RiskEvidenceSynthesis, SubstanceSpecification
Add codes ActorDefinition, AdministrableProductDefinition, ArtifactAssessment, BiologicallyDerivedProductDispense, Citation, ClinicalUseDefinition, ConditionDefinition, DeviceAssociation, DeviceDispense, DeviceUsage, EncounterHistory, EvidenceReport, FormularyItem, GenomicStudy, ImagingSelection, Ingredient, InventoryItem, InventoryReport, ManufacturedItemDefinition, MedicinalProductDefinition, NutritionIntake, NutritionProduct, PackagedProductDefinition, Permission, RegulatedAuthorization, RequestOrchestration, Requirements, SubscriptionStatus, SubscriptionTopic, SubstanceDefinition, TestPlan, Transport

CapabilityStatement.rest.resource.conditionalPatch

Added Element

CapabilityStatement.messaging.endpoint.protocol

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/message-transport" to "http://hl7.org/fhir/message-transport"

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

See R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

Structure

Description & Constraints

CapabilityStatement

DomainResource

url

Σ C

0..1

uri

Canonical identifier for this capability statement, represented as a URI (globally unique)
+ Warning: URL should not contain | or # - these characters make processing canonical references problematic

identifier

Σ TU

0..*

Identifier

Additional identifier for the CapabilityStatement (business identifier)

version

0..1

string

Business version of the capability statement

versionAlgorithm[x]

Σ TU

0..1

How to compare versions
Binding: Version Algorithm (Extensible)

versionAlgorithmString

string

versionAlgorithmCoding

Coding

name

Σ C

0..1

string

Name for this capability statement (computer friendly)

title

Σ T

0..1

string

Name for this capability statement (human friendly)

status

?!Σ

1..1

code

draft | active | retired | unknown
Binding: PublicationStatus (Required)

experimental

0..1

boolean

For testing purposes, not real usage

date

1..1

dateTime

Date last changed

publisher

Σ T

0..1

string

Name of the publisher/steward (organization or individual)

contact

0..*

ContactDetail

Contact details for the publisher

description

T C

0..1

markdown

Natural language description of the capability statement

useContext

Σ TU

0..*

UsageContext

The context that the content is intended to support

jurisdiction

Σ XD

0..*

CodeableConcept

Intended jurisdiction for capability statement (if applicable)
Binding: Jurisdiction ValueSet (Extensible)

purpose

0..1

markdown

Why this capability statement is defined

0..1

markdown

Use and/or publishing restrictions

copyrightLabel

T TU

0..1

string

kind

Σ C

1..1

code

instance | capability | requirements
Binding: Capability Statement Kind (Required)

instantiates

0..*

canonical(CapabilityStatement)

Canonical URL of another capability statement this implements

imports

Σ TU

0..*

canonical(CapabilityStatement)

Canonical URL of another capability statement this adds to

software

Σ C

0..1

BackboneElement

Software that is covered by this capability statement

name

1..1

string

A name the software is known by

version

0..1

string

Version covered by this statement

releaseDate

0..1

dateTime

Date this version was released

implementation

Σ C

0..1

BackboneElement

If this describes a specific instance

description

1..1

markdown

Describes this specific instance

url

0..1

url

Base URL for the installation

custodian

Σ TU

0..1

Reference(Organization)

Organization that manages the data

fhirVersion

1..1

code

FHIR Version the system supports
Binding: FHIRVersion (Required)

format

1..*

code

formats supported (xml | json | ttl | mime type)
Binding: Mime Types (Required)

Additional Bindings

Purpose

Capability Format Type

Starter Set

patchFormat

0..*

code

Patch formats supported
Binding: Mime Types (Required)

acceptLanguage

Σ TU

0..*

code

Languages supported
Binding: All Languages (Required)

Additional Bindings

Purpose

Common Languages

Starter Set

implementationGuide

0..*

canonical(ImplementationGuide)

Implementation guides supported

rest

Σ C

0..*

BackboneElement

If the endpoint is a RESTful one
+ Rule: A given resource can only be described once per RESTful mode.

mode

Σ C

1..1

code

client | server
Binding: Restful Capability Mode (Required)

documentation

0..1

markdown

General description of implementation

security

Σ TU

0..1

BackboneElement

Information about security of implementation

cors

0..1

boolean

Adds CORS Headers (http://enable-cors.org/)

0..*

0..1

General description of how security works

resource

Σ C

0..*

BackboneElement

Resource served on the REST interface
+ Rule: Search parameter names must be unique in the context of a resource.

type

Σ C

1..1

code

A resource type that is supported
Binding: Resource Types (Required)

profile

0..1

canonical(StructureDefinition)

System-wide profile

supportedProfile

Σ TU

0..*

canonical(StructureDefinition)

Use-case specific profiles

documentation

0..1

markdown

Additional information about the use of the resource type

interaction

0..*

BackboneElement

What operations are supported?

code

1..1

code

documentation

0..1

markdown

Anything special about operation behavior

versioning

0..1

code

no-version | versioned | versioned-update
Binding: Resource Version Policy (Required)

readHistory

0..1

boolean

Whether vRead can return past versions

updateCreate

0..1

boolean

If update can commit to a new identity

conditionalCreate

0..1

boolean

If allows/uses conditional create

conditionalRead

0..1

code

not-supported | modified-since | not-match | full-support
Binding: Conditional Read Status (Required)

conditionalUpdate

0..1

boolean

If allows/uses conditional update

conditionalPatch

0..1

boolean

If allows/uses conditional patch

conditionalDelete

0..1

code

not-supported | single | multiple - how conditional delete is supported
Binding: Conditional Delete Status (Required)

referencePolicy

0..*

code

literal | logical | resolves | enforced | local
Binding: Reference Handling Policy (Required)

searchInclude

0..*

string

_include values supported by the server

searchRevInclude

0..*

string

_revinclude values supported by the server

searchParam

0..*

BackboneElement

Search parameters supported by implementation

name

1..1

string

Name for parameter in search url

definition

0..1

canonical(SearchParameter)

Source of definition for parameter

type

1..1

code

documentation

0..1

markdown

Server-specific usage

operation

0..*

BackboneElement

Definition of a resource operation

name

1..1

string

Name by which the operation/query is invoked

definition

1..1

canonical(OperationDefinition)

The defined operation/query

documentation

0..1

markdown

Specific details about operation behavior

interaction

0..*

BackboneElement

What operations are supported?

code

1..1

code

transaction | batch | search-system | history-system
Binding: System Restful Interaction (Required)

documentation

0..1

markdown

Anything special about operation behavior

searchParam

0..*

see searchParam

Search parameters for searching all resources

operation

0..*

see operation

Definition of a system level operation

compartment

0..*

canonical(CompartmentDefinition)

Compartments served/used by system

messaging

Σ C TU

0..*

BackboneElement

If messaging is supported

endpoint

0..*

BackboneElement

Where messages should be sent

protocol

1..1

Coding

http | ftp | mllp +
Binding: Message Transport (Extensible)

address

1..1

url

Network address or identifier of the end-point

reliableCache

0..1

unsignedInt

Reliable Message Cache Length (min)

documentation

0..1

markdown

Messaging interface behavior details

supportedMessage

0..*

BackboneElement

Messages supported by this system

mode

1..1

code

sender | receiver
Binding: Event Capability Mode (Required)

definition

1..1

canonical(MessageDefinition)

Message supported by this system

document

Σ C TU

0..*

BackboneElement

Document definition

mode

Σ C

1..1

code

producer | consumer
Binding: Document Mode (Required)

documentation

0..1

markdown

Description of document support

profile

Σ C

1..1

canonical(StructureDefinition)

Constraint on the resources used in the document

Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<CapabilityStatement xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this capability statement, represented as a URI (globally unique) -->
 <identifier><!-- 0..* Identifier Additional identifier for the CapabilityStatement (business identifier) --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the capability statement -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this capability statement (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this capability statement (human friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 1..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- I 0..1 Natural language description of the capability statement -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for capability statement (if applicable) --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this capability statement is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) -->
 <kind value="[code]"/><!-- I 1..1 instance | capability | requirements -->
 <instantiates><!-- 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this implements --></instantiates>
 <imports><!-- 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this adds to --></imports>
 <software>  <!-- I 0..1 Software that is covered by this capability statement -->
  <name value="[string]"/><!-- 1..1 A name the software is known by -->
  <version value="[string]"/><!-- 0..1 Version covered by this statement -->
  <releaseDate value="[dateTime]"/><!-- 0..1 Date this version was released -->
 </software>
 <implementation>  <!-- I 0..1 If this describes a specific instance -->
  <description value="[markdown]"/><!-- 1..1 Describes this specific instance -->
  <url value="[url]"/><!-- 0..1 Base URL for the installation -->
  <custodian><!-- 0..1 Reference(Organization) Organization that manages the data --></custodian>
 </implementation>
 <fhirVersion value="[code]"/><!-- 1..1 FHIR Version the system supports -->
 <format value="[code]"/><!-- 1..* formats supported (xml | json | ttl | mime type) -->
 <patchFormat value="[code]"/><!-- 0..* Patch formats supported -->
 <acceptLanguage value="[code]"/><!-- 0..* Languages supported -->
 <implementationGuide><!-- 0..* canonical(ImplementationGuide) Implementation guides supported --></implementationGuide>
 <rest>  <!-- I 0..* If the endpoint is a RESTful one -->
  <mode value="[code]"/><!-- I 1..1 client | server -->
  <documentation value="[markdown]"/><!-- 0..1 General description of implementation -->
  <security>  <!-- 0..1 Information about security of implementation -->
   <cors value="[boolean]"/><!-- 0..1 Adds CORS Headers (http://enable-cors.org/) -->
   <service><!-- 0..* CodeableConcept OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates --></service>
   <description value="[markdown]"/><!-- 0..1 General description of how security works -->
  </security>
  <resource>  <!-- I 0..* Resource served on the REST interface -->
   <type value="[code]"/><!-- I 1..1 A resource type that is supported -->
   <profile><!-- 0..1 canonical(StructureDefinition) System-wide profile --></profile>
   <supportedProfile><!-- 0..* canonical(StructureDefinition) Use-case specific profiles --></supportedProfile>
   <documentation value="[markdown]"/><!-- 0..1 Additional information about the use of the resource type -->
   <interaction>  <!-- 0..* What operations are supported? -->
    <code value="[code]"/><!-- 1..1 read | vread | update | patch | delete | history-instance | history-type | create | search-type -->
    <documentation value="[markdown]"/><!-- 0..1 Anything special about operation behavior -->
   </interaction>
   <versioning value="[code]"/><!-- 0..1 no-version | versioned | versioned-update -->
   <readHistory value="[boolean]"/><!-- 0..1 Whether vRead can return past versions -->
   <updateCreate value="[boolean]"/><!-- 0..1 If update can commit to a new identity -->
   <conditionalCreate value="[boolean]"/><!-- 0..1 If allows/uses conditional create -->
   <conditionalRead value="[code]"/><!-- 0..1 not-supported | modified-since | not-match | full-support -->
   <conditionalUpdate value="[boolean]"/><!-- 0..1 If allows/uses conditional update -->
   <conditionalPatch value="[boolean]"/><!-- 0..1 If allows/uses conditional patch -->
   <conditionalDelete value="[code]"/><!-- 0..1 not-supported | single | multiple - how conditional delete is supported -->
   <referencePolicy value="[code]"/><!-- 0..* literal | logical | resolves | enforced | local -->
   <searchInclude value="[string]"/><!-- 0..* _include values supported by the server -->
   <searchRevInclude value="[string]"/><!-- 0..* _revinclude values supported by the server -->
   <searchParam>  <!-- I 0..* Search parameters supported by implementation -->
    <name value="[string]"/><!-- I 1..1 Name for parameter in search url -->
    <definition><!-- 0..1 canonical(SearchParameter) Source of definition for parameter --></definition>
    <type value="[code]"/><!-- 1..1 number | date | string | token | reference | composite | quantity | uri | special -->
    <documentation value="[markdown]"/><!-- 0..1 Server-specific usage -->
   </searchParam>
   <operation>  <!-- 0..* Definition of a resource operation -->
    <name value="[string]"/><!-- 1..1 Name by which the operation/query is invoked -->
    <definition><!-- 1..1 canonical(OperationDefinition) The defined operation/query --></definition>
    <documentation value="[markdown]"/><!-- 0..1 Specific details about operation behavior -->
   </operation>
  </resource>
  <interaction>  <!-- 0..* What operations are supported? -->
   <code value="[code]"/><!-- 1..1 transaction | batch | search-system | history-system -->
   <documentation value="[markdown]"/><!-- 0..1 Anything special about operation behavior -->
  </interaction>
  <searchParam><!-- 0..* Content as for CapabilityStatement.rest.resource.searchParam Search parameters for searching all resources --></searchParam>
  <operation><!-- 0..* Content as for CapabilityStatement.rest.resource.operation Definition of a system level operation --></operation>
  <compartment><!-- 0..* canonical(CompartmentDefinition) Compartments served/used by system --></compartment>
 </rest>
 <messaging>  <!-- I 0..* If messaging is supported -->
  <endpoint>  <!-- I 0..* Where messages should be sent -->
   <protocol><!-- 1..1 Coding http | ftp | mllp + --></protocol>
   <address value="[url]"/><!-- 1..1 Network address or identifier of the end-point -->
  </endpoint>
  <reliableCache value="[unsignedInt]"/><!-- 0..1 Reliable Message Cache Length (min) -->
  <documentation value="[markdown]"/><!-- 0..1 Messaging interface behavior details -->
  <supportedMessage>  <!-- 0..* Messages supported by this system -->
   <mode value="[code]"/><!-- 1..1 sender | receiver -->
   <definition><!-- 1..1 canonical(MessageDefinition) Message supported by this system --></definition>
  </supportedMessage>
 </messaging>
 <document>  <!-- I 0..* Document definition -->
  <mode value="[code]"/><!-- I 1..1 producer | consumer -->
  <documentation value="[markdown]"/><!-- 0..1 Description of document support -->
  <profile><!-- I 1..1 canonical(StructureDefinition) Constraint on the resources used in the document --></profile>
 </document>
</CapabilityStatement>

JSON Template

{
  "resourceType" : "CapabilityStatement",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Canonical identifier for this capability statement, represented as a URI (globally unique)
  "identifier" : [{ Identifier }], // Additional identifier for the CapabilityStatement (business identifier)
  "version" : "<string>", // Business version of the capability statement
  // versionAlgorithm[x]: How to compare versions. One of these 2:
  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this capability statement (computer friendly)
  "title" : "<string>", // Name for this capability statement (human friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // R!  Date last changed
  "publisher" : "<string>", // Name of the publisher/steward (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // I Natural language description of the capability statement
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for capability statement (if applicable)
  "purpose" : "<markdown>", // Why this capability statement is defined
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "copyrightLabel" : "<string>", // Copyright holder and year(s)
  "kind" : "<code>", // I R!  instance | capability | requirements
  "instantiates" : ["<canonical(CapabilityStatement)>"], // Canonical URL of another capability statement this implements
  "imports" : ["<canonical(CapabilityStatement)>"], // Canonical URL of another capability statement this adds to
  "software" : { // I Software that is covered by this capability statement
    "name" : "<string>", // R!  A name the software is known by
    "version" : "<string>", // Version covered by this statement
    "releaseDate" : "<dateTime>" // Date this version was released
  },
  "implementation" : { // I If this describes a specific instance
    "description" : "<markdown>", // R!  Describes this specific instance
    "url" : "<url>", // Base URL for the installation
    "custodian" : { Reference(Organization) } // Organization that manages the data
  },
  "fhirVersion" : "<code>", // R!  FHIR Version the system supports
  "format" : ["<code>"], // R!  formats supported (xml | json | ttl | mime type)
  "patchFormat" : ["<code>"], // Patch formats supported
  "acceptLanguage" : ["<code>"], // Languages supported
  "implementationGuide" : ["<canonical(ImplementationGuide)>"], // Implementation guides supported
  "rest" : [{ // I If the endpoint is a RESTful one
    "mode" : "<code>", // I R!  client | server
    "documentation" : "<markdown>", // General description of implementation
    "security" : { // Information about security of implementation
      "cors" : <boolean>, // Adds CORS Headers (http://enable-cors.org/)
      "service" : [{ CodeableConcept }], // OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
      "description" : "<markdown>" // General description of how security works
    },
    "resource" : [{ // I Resource served on the REST interface
      "type" : "<code>", // I R!  A resource type that is supported
      "profile" : "<canonical(StructureDefinition)>", // System-wide profile
      "supportedProfile" : ["<canonical(StructureDefinition)>"], // Use-case specific profiles
      "documentation" : "<markdown>", // Additional information about the use of the resource type
      "interaction" : [{ // What operations are supported?
        "code" : "<code>", // R!  read | vread | update | patch | delete | history-instance | history-type | create | search-type
        "documentation" : "<markdown>" // Anything special about operation behavior
      }],
      "versioning" : "<code>", // no-version | versioned | versioned-update
      "readHistory" : <boolean>, // Whether vRead can return past versions
      "updateCreate" : <boolean>, // If update can commit to a new identity
      "conditionalCreate" : <boolean>, // If allows/uses conditional create
      "conditionalRead" : "<code>", // not-supported | modified-since | not-match | full-support
      "conditionalUpdate" : <boolean>, // If allows/uses conditional update
      "conditionalPatch" : <boolean>, // If allows/uses conditional patch
      "conditionalDelete" : "<code>", // not-supported | single | multiple - how conditional delete is supported
      "referencePolicy" : ["<code>"], // literal | logical | resolves | enforced | local
      "searchInclude" : ["<string>"], // _include values supported by the server
      "searchRevInclude" : ["<string>"], // _revinclude values supported by the server
      "searchParam" : [{ // I Search parameters supported by implementation
        "name" : "<string>", // I R!  Name for parameter in search url
        "definition" : "<canonical(SearchParameter)>", // Source of definition for parameter
        "type" : "<code>", // R!  number | date | string | token | reference | composite | quantity | uri | special
        "documentation" : "<markdown>" // Server-specific usage
      }],
      "operation" : [{ // Definition of a resource operation
        "name" : "<string>", // R!  Name by which the operation/query is invoked
        "definition" : "<canonical(OperationDefinition)>", // R!  The defined operation/query
        "documentation" : "<markdown>" // Specific details about operation behavior
      }]
    }],
    "interaction" : [{ // What operations are supported?
      "code" : "<code>", // R!  transaction | batch | search-system | history-system
      "documentation" : "<markdown>" // Anything special about operation behavior
    }],
    "searchParam" : [{ Content as for CapabilityStatement.rest.resource.searchParam }], // Search parameters for searching all resources
    "operation" : [{ Content as for CapabilityStatement.rest.resource.operation }], // Definition of a system level operation
    "compartment" : ["<canonical(CompartmentDefinition)>"] // Compartments served/used by system
  }],
  "messaging" : [{ // I If messaging is supported
    "endpoint" : [{ // I Where messages should be sent
      "protocol" : { Coding }, // R!  http | ftp | mllp +
      "address" : "<url>" // R!  Network address or identifier of the end-point
    }],
    "reliableCache" : "<unsignedInt>", // Reliable Message Cache Length (min)
    "documentation" : "<markdown>", // Messaging interface behavior details
    "supportedMessage" : [{ // Messages supported by this system
      "mode" : "<code>", // R!  sender | receiver
      "definition" : "<canonical(MessageDefinition)>" // R!  Message supported by this system
    }]
  }],
  "document" : [{ // I Document definition
    "mode" : "<code>", // I R!  producer | consumer
    "documentation" : "<markdown>", // Description of document support
    "profile" : "<canonical(StructureDefinition)>" // I R!  Constraint on the resources used in the document
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:CapabilityStatement;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:url [ uri ] ; # 0..1 Canonical identifier for this capability statement, represented as a URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Additional identifier for the CapabilityStatement (business identifier)
  fhir:version [ string ] ; # 0..1 Business version of the capability statement
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:string ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this capability statement (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this capability statement (human friendly)
  fhir:status [ code ] ; # 1..1 draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 For testing purposes, not real usage
  fhir:date [ dateTime ] ; # 1..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual)
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 I Natural language description of the capability statement
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for capability statement (if applicable)
  fhir:purpose [ markdown ] ; # 0..1 Why this capability statement is defined
  fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions
  fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s)
  fhir:kind [ code ] ; # 1..1 I instance | capability | requirements
  fhir:instantiates  ( [ canonical(CapabilityStatement) ] ... ) ; # 0..* Canonical URL of another capability statement this implements
  fhir:imports  ( [ canonical(CapabilityStatement) ] ... ) ; # 0..* Canonical URL of another capability statement this adds to
  fhir:software [ # 0..1 I Software that is covered by this capability statement
    fhir:name [ string ] ; # 1..1 A name the software is known by
    fhir:version [ string ] ; # 0..1 Version covered by this statement
    fhir:releaseDate [ dateTime ] ; # 0..1 Date this version was released
  ] ;
  fhir:implementation [ # 0..1 I If this describes a specific instance
    fhir:description [ markdown ] ; # 1..1 Describes this specific instance
    fhir:url [ url ] ; # 0..1 Base URL for the installation
    fhir:custodian [ Reference(Organization) ] ; # 0..1 Organization that manages the data
  ] ;
  fhir:fhirVersion [ code ] ; # 1..1 FHIR Version the system supports
  fhir:format  ( [ code ] ... ) ; # 1..* formats supported (xml | json | ttl | mime type)
  fhir:patchFormat  ( [ code ] ... ) ; # 0..* Patch formats supported
  fhir:acceptLanguage  ( [ code ] ... ) ; # 0..* Languages supported
  fhir:implementationGuide  ( [ canonical(ImplementationGuide) ] ... ) ; # 0..* Implementation guides supported
  fhir:rest ( [ # 0..* I If the endpoint is a RESTful one
    fhir:mode [ code ] ; # 1..1 I client | server
    fhir:documentation [ markdown ] ; # 0..1 General description of implementation
    fhir:security [ # 0..1 Information about security of implementation
      fhir:cors [ boolean ] ; # 0..1 Adds CORS Headers (http://enable-cors.org/)
      fhir:service  ( [ CodeableConcept ] ... ) ; # 0..* OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
      fhir:description [ markdown ] ; # 0..1 General description of how security works
    ] ;
    fhir:resource ( [ # 0..* I Resource served on the REST interface
      fhir:type [ code ] ; # 1..1 I A resource type that is supported
      fhir:profile [ canonical(StructureDefinition) ] ; # 0..1 System-wide profile
      fhir:supportedProfile  ( [ canonical(StructureDefinition) ] ... ) ; # 0..* Use-case specific profiles
      fhir:documentation [ markdown ] ; # 0..1 Additional information about the use of the resource type
      fhir:interaction ( [ # 0..* What operations are supported?
        fhir:code [ code ] ; # 1..1 read | vread | update | patch | delete | history-instance | history-type | create | search-type
        fhir:documentation [ markdown ] ; # 0..1 Anything special about operation behavior
      ] ... ) ;
      fhir:versioning [ code ] ; # 0..1 no-version | versioned | versioned-update
      fhir:readHistory [ boolean ] ; # 0..1 Whether vRead can return past versions
      fhir:updateCreate [ boolean ] ; # 0..1 If update can commit to a new identity
      fhir:conditionalCreate [ boolean ] ; # 0..1 If allows/uses conditional create
      fhir:conditionalRead [ code ] ; # 0..1 not-supported | modified-since | not-match | full-support
      fhir:conditionalUpdate [ boolean ] ; # 0..1 If allows/uses conditional update
      fhir:conditionalPatch [ boolean ] ; # 0..1 If allows/uses conditional patch
      fhir:conditionalDelete [ code ] ; # 0..1 not-supported | single | multiple - how conditional delete is supported
      fhir:referencePolicy  ( [ code ] ... ) ; # 0..* literal | logical | resolves | enforced | local
      fhir:searchInclude  ( [ string ] ... ) ; # 0..* _include values supported by the server
      fhir:searchRevInclude  ( [ string ] ... ) ; # 0..* _revinclude values supported by the server
      fhir:searchParam ( [ # 0..* I Search parameters supported by implementation
        fhir:name [ string ] ; # 1..1 I Name for parameter in search url
        fhir:definition [ canonical(SearchParameter) ] ; # 0..1 Source of definition for parameter
        fhir:type [ code ] ; # 1..1 number | date | string | token | reference | composite | quantity | uri | special
        fhir:documentation [ markdown ] ; # 0..1 Server-specific usage
      ] ... ) ;
      fhir:operation ( [ # 0..* Definition of a resource operation
        fhir:name [ string ] ; # 1..1 Name by which the operation/query is invoked
        fhir:definition [ canonical(OperationDefinition) ] ; # 1..1 The defined operation/query
        fhir:documentation [ markdown ] ; # 0..1 Specific details about operation behavior
      ] ... ) ;
    ] ... ) ;
    fhir:interaction ( [ # 0..* What operations are supported?
      fhir:code [ code ] ; # 1..1 transaction | batch | search-system | history-system
      fhir:documentation [ markdown ] ; # 0..1 Anything special about operation behavior
    ] ... ) ;
    fhir:searchParam  ( [ See CapabilityStatement.rest.resource.searchParam ] ... ) ; # 0..* Search parameters for searching all resources
    fhir:operation  ( [ See CapabilityStatement.rest.resource.operation ] ... ) ; # 0..* Definition of a system level operation
    fhir:compartment  ( [ canonical(CompartmentDefinition) ] ... ) ; # 0..* Compartments served/used by system
  ] ... ) ;
  fhir:messaging ( [ # 0..* I If messaging is supported
    fhir:endpoint ( [ # 0..* I Where messages should be sent
      fhir:protocol [ Coding ] ; # 1..1 http | ftp | mllp +
      fhir:address [ url ] ; # 1..1 Network address or identifier of the end-point
    ] ... ) ;
    fhir:reliableCache [ unsignedInt ] ; # 0..1 Reliable Message Cache Length (min)
    fhir:documentation [ markdown ] ; # 0..1 Messaging interface behavior details
    fhir:supportedMessage ( [ # 0..* Messages supported by this system
      fhir:mode [ code ] ; # 1..1 sender | receiver
      fhir:definition [ canonical(MessageDefinition) ] ; # 1..1 Message supported by this system
    ] ... ) ;
  ] ... ) ;
  fhir:document ( [ # 0..* I Document definition
    fhir:mode [ code ] ; # 1..1 I producer | consumer
    fhir:documentation [ markdown ] ; # 0..1 Description of document support
    fhir:profile [ canonical(StructureDefinition) ] ; # 1..1 I Constraint on the resources used in the document
  ] ... ) ;
]

Changes from R4 and R4B

CapabilityStatement

CapabilityStatement.identifier

Added Element

CapabilityStatement.versionAlgorithm[x]

Added Element

CapabilityStatement.copyrightLabel

Added Element

CapabilityStatement.implementation.description

Type changed from string to markdown

CapabilityStatement.fhirVersion

Add codes 0.0, 0.4, 0.5, 1.0, 1.1, 1.4, 1.6, 1.8, 3.0, 3.0.2, 3.3, 3.5, 4.0, 4.0.1, 4.1, 4.1.0, 4.2, 4.2.0, 4.3, 4.3.0, 4.3.0-cibuild, 4.3.0-snapshot1, 4.4, 4.4.0, 4.5, 4.5.0, 4.6, 4.6.0, 5.0, 5.0.0, 5.0.0-cibuild, 5.0.0-snapshot1, 5.0.0-snapshot2, 5.0.0-ballot, 5.0.0-snapshot3, 5.0.0-draft-final

CapabilityStatement.acceptLanguage

Added Element

CapabilityStatement.rest.security.service

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/restful-security-service" to "http://hl7.org/fhir/restful-security-service"

CapabilityStatement.rest.resource.type

Remove codes CatalogEntry, DeviceUseStatement, DocumentManifest, DomainResource, EffectEvidenceSynthesis, Media, MedicinalProduct, MedicinalProductAuthorization, MedicinalProductContraindication, MedicinalProductIndication, MedicinalProductIngredient, MedicinalProductInteraction, MedicinalProductManufactured, MedicinalProductPackaged, MedicinalProductPharmaceutical, MedicinalProductUndesirableEffect, RequestGroup, ResearchDefinition, ResearchElementDefinition, Resource, RiskEvidenceSynthesis, SubstanceSpecification
Add codes ActorDefinition, AdministrableProductDefinition, ArtifactAssessment, BiologicallyDerivedProductDispense, Citation, ClinicalUseDefinition, ConditionDefinition, DeviceAssociation, DeviceDispense, DeviceUsage, EncounterHistory, EvidenceReport, FormularyItem, GenomicStudy, ImagingSelection, Ingredient, InventoryItem, InventoryReport, ManufacturedItemDefinition, MedicinalProductDefinition, NutritionIntake, NutritionProduct, PackagedProductDefinition, Permission, RegulatedAuthorization, RequestOrchestration, Requirements, SubscriptionStatus, SubscriptionTopic, SubstanceDefinition, TestPlan, Transport

CapabilityStatement.rest.resource.conditionalPatch

Added Element

CapabilityStatement.messaging.endpoint.protocol

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/message-transport" to "http://hl7.org/fhir/message-transport"

Changes from R4 and R4B

CapabilityStatement

CapabilityStatement.identifier

Added Element

CapabilityStatement.versionAlgorithm[x]

Added Element

CapabilityStatement.copyrightLabel

Added Element

CapabilityStatement.implementation.description

Type changed from string to markdown

CapabilityStatement.fhirVersion

Add codes 0.0, 0.4, 0.5, 1.0, 1.1, 1.4, 1.6, 1.8, 3.0, 3.0.2, 3.3, 3.5, 4.0, 4.0.1, 4.1, 4.1.0, 4.2, 4.2.0, 4.3, 4.3.0, 4.3.0-cibuild, 4.3.0-snapshot1, 4.4, 4.4.0, 4.5, 4.5.0, 4.6, 4.6.0, 5.0, 5.0.0, 5.0.0-cibuild, 5.0.0-snapshot1, 5.0.0-snapshot2, 5.0.0-ballot, 5.0.0-snapshot3, 5.0.0-draft-final

CapabilityStatement.acceptLanguage

Added Element

CapabilityStatement.rest.security.service

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/restful-security-service" to "http://hl7.org/fhir/restful-security-service"

CapabilityStatement.rest.resource.type

Remove codes CatalogEntry, DeviceUseStatement, DocumentManifest, DomainResource, EffectEvidenceSynthesis, Media, MedicinalProduct, MedicinalProductAuthorization, MedicinalProductContraindication, MedicinalProductIndication, MedicinalProductIngredient, MedicinalProductInteraction, MedicinalProductManufactured, MedicinalProductPackaged, MedicinalProductPharmaceutical, MedicinalProductUndesirableEffect, RequestGroup, ResearchDefinition, ResearchElementDefinition, Resource, RiskEvidenceSynthesis, SubstanceSpecification
Add codes ActorDefinition, AdministrableProductDefinition, ArtifactAssessment, BiologicallyDerivedProductDispense, Citation, ClinicalUseDefinition, ConditionDefinition, DeviceAssociation, DeviceDispense, DeviceUsage, EncounterHistory, EvidenceReport, FormularyItem, GenomicStudy, ImagingSelection, Ingredient, InventoryItem, InventoryReport, ManufacturedItemDefinition, MedicinalProductDefinition, NutritionIntake, NutritionProduct, PackagedProductDefinition, Permission, RegulatedAuthorization, RequestOrchestration, Requirements, SubscriptionStatus, SubscriptionTopic, SubstanceDefinition, TestPlan, Transport

CapabilityStatement.rest.resource.conditionalPatch

Added Element

CapabilityStatement.messaging.endpoint.protocol

Change code system for extensibly bound codes from "http://terminology.hl7.org/CodeSystem/message-transport" to "http://hl7.org/fhir/message-transport"

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

See R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) , the spreadsheet version & the dependency analysis

5.3.4.1 Terminology Bindings

Path ValueSet Type Documentation

CapabilityStatement.versionAlgorithm[x]

Path	ValueSet	Type	Documentation
CapabilityStatement.versionAlgorithm[x]	VersionAlgorithm	Extensible	Indicates the mechanism used to compare versions to determine which is more current.
CapabilityStatement.status	PublicationStatus	Required	The lifecycle status of an artifact.
CapabilityStatement.jurisdiction	JurisdictionValueSet	Extensible	This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used. Note: The codes for countries and country subdivisions are taken from ISO 3166 while the codes for "supra-national" regions are from UN Standard country or area codes for statistical use (M49) .
CapabilityStatement.kind	CapabilityStatementKind	Required	How a capability statement is intended to be used.
CapabilityStatement.fhirVersion	FHIRVersion	Required	All published FHIR Versions.
CapabilityStatement.format	MimeTypes (a valid code from `urn:ietf:bcp:13`)	Required	This value set includes all possible codes from BCP-13 (see http://tools.ietf.org/html/bcp13)
	Capability Format Type	starter
CapabilityStatement.patchFormat	MimeTypes (a valid code from `urn:ietf:bcp:13`)	Required	This value set includes all possible codes from BCP-13 (see http://tools.ietf.org/html/bcp13)
CapabilityStatement.acceptLanguage	AllLanguages (a valid code from Tags for the Identification of Languages )	Required	This value set includes all possible codes from BCP-47 (see http://tools.ietf.org/html/bcp47)
	Common Languages	starter
CapabilityStatement.rest.mode	RestfulCapabilityMode	Required	The mode of a RESTful capability statement.
CapabilityStatement.rest.security.service	RestfulSecurityService	Extensible	Types of security services used with FHIR.
CapabilityStatement.rest.resource.type	ResourceType	Required	Concrete FHIR Resource Types
CapabilityStatement.rest.resource.interaction.code	TypeRestfulInteraction	Required	Operations supported by REST at the type or instance level.
CapabilityStatement.rest.resource.versioning	ResourceVersionPolicy	Required	How the system supports versioning for a resource.
CapabilityStatement.rest.resource.conditionalRead	ConditionalReadStatus	Required	A code that indicates how the server supports conditional read.
CapabilityStatement.rest.resource.conditionalDelete	ConditionalDeleteStatus	Required	A code that indicates how the server supports conditional delete.
CapabilityStatement.rest.resource.referencePolicy	ReferenceHandlingPolicy	Required	A set of flags that defines how references are supported.
CapabilityStatement.rest.resource.searchParam.type	SearchParamType	Required	Data types allowed to be used for search parameters.
CapabilityStatement.rest.interaction.code	SystemRestfulInteraction	Required	Operations supported by REST at the system level.
CapabilityStatement.messaging.endpoint.protocol	MessageTransport	Extensible	The protocol used for message transport.
CapabilityStatement.messaging.supportedMessage.mode	EventCapabilityMode	Required	The mode of a message capability statement.
CapabilityStatement.document.mode	DocumentMode	Required	Whether the application produces or consumes documents.

VersionAlgorithm

Extensible

Indicates the mechanism used to compare versions to determine which is more current.

CapabilityStatement.status

PublicationStatus

Required

The lifecycle status of an artifact.

CapabilityStatement.jurisdiction

JurisdictionValueSet

Extensible

This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used.

Note: The codes for countries and country subdivisions are taken from ISO 3166 icon while the codes for "supra-national" regions are from UN Standard country or area codes for statistical use (M49) icon .

CapabilityStatement.kind

CapabilityStatementKind

Required

How a capability statement is intended to be used.

CapabilityStatement.fhirVersion

FHIRVersion

Required

All published FHIR Versions.

CapabilityStatement.format

MimeTypes (a valid code from urn:ietf:bcp:13)

Required

This value set includes all possible codes from BCP-13 (see http://tools.ietf.org/html/bcp13)

Capability Format Type

starter

CapabilityStatement.patchFormat

MimeTypes (a valid code from urn:ietf:bcp:13)

Required

This value set includes all possible codes from BCP-13 (see http://tools.ietf.org/html/bcp13)

CapabilityStatement.acceptLanguage

AllLanguages (a valid code from Tags for the Identification of Languages icon

)

Required

This value set includes all possible codes from BCP-47 (see http://tools.ietf.org/html/bcp47)

Common Languages

starter

CapabilityStatement.rest.mode

RestfulCapabilityMode

Required

The mode of a RESTful capability statement.

CapabilityStatement.rest.security.service

RestfulSecurityService

Extensible

Types of security services used with FHIR.

CapabilityStatement.rest.resource.type

ResourceType

Required

Concrete FHIR Resource Types

CapabilityStatement.rest.resource.interaction.code

TypeRestfulInteraction

Required

Operations supported by REST at the type or instance level.

CapabilityStatement.rest.resource.versioning

ResourceVersionPolicy

Required

How the system supports versioning for a resource.

CapabilityStatement.rest.resource.conditionalRead

ConditionalReadStatus

Required

A code that indicates how the server supports conditional read.

CapabilityStatement.rest.resource.conditionalDelete

ConditionalDeleteStatus

Required

A code that indicates how the server supports conditional delete.

CapabilityStatement.rest.resource.referencePolicy

ReferenceHandlingPolicy

Required

A set of flags that defines how references are supported.

CapabilityStatement.rest.resource.searchParam.type

SearchParamType

Required

Data types allowed to be used for search parameters.

CapabilityStatement.rest.interaction.code

SystemRestfulInteraction

Required

Operations supported by REST at the system level.

CapabilityStatement.messaging.endpoint.protocol

MessageTransport

Extensible

The protocol used for message transport.

CapabilityStatement.messaging.supportedMessage.mode

EventCapabilityMode

Required

The mode of a message capability statement.

CapabilityStatement.document.mode

DocumentMode

Required

Whether the application produces or consumes documents.

5.3.4.2 Constraints

UniqueKey

Level

Location

Description

Expression

cnl-0

Warning

(base)

Name should be usable as an identifier for the module by machine processing applications such as code generation

name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')

cnl-1

Warning

CapabilityStatement.url

URL should not contain | or # - these characters make processing canonical references problematic

exists() implies matches('^[^|# ]+$')

cpb-1

Rule

(base)

A Capability Statement SHALL have at least one of REST, messaging or document element.

rest.exists() or messaging.exists() or document.exists()

cpb-2

Rule

(base)

A Capability Statement SHALL have at least one of description, software, or implementation element.

(description.count() + software.count() + implementation.count()) > 0

cpb-3

Rule

(base)

Messaging end-point is only permitted when a capability statement is for an implementation.

messaging.endpoint.empty() or kind = 'instance'

cpb-4

Rule

(base)

There should only be one CapabilityStatement.rest per mode.

rest.mode.isDistinct()

cpb-7

Rule

(base)

The set of documents must be unique by the combination of profile and mode.

document.select(profile&mode).isDistinct()

cpb-9

Rule

CapabilityStatement.rest

A given resource can only be described once per RESTful mode.

resource.select(type).isDistinct()

cpb-12

Rule

CapabilityStatement.rest.resource

Search parameter names must be unique in the context of a resource.

searchParam.select(name).isDistinct()

cpb-14

Rule

(base)

If kind = instance, implementation must be present and software may be present

(kind != 'instance') or implementation.exists()

cpb-15

Rule

(base)

If kind = capability, implementation must be absent, software must be present

(kind != 'capability') or (implementation.exists().not() and software.exists())

cpb-16

Rule

(base)

If kind = requirements, implementation and software must be absent

(kind!='requirements') or (implementation.exists().not() and software.exists().not())

5.3.5 Notes:

The CapabilityStatement resource provides for an application to describe its use of the RESTful paradigm messaging events, or FHIR documents. Usually, an application would only describe one, but more than one may be described
RESTful CapabilityStatement rules:
- RESTful servers are required to provide this resource on demand. Servers SHALL specify what resource types and operations are supported, and SHOULD also specify profiles for each resource type.
- The CapabilityStatement returned in the capabilities interaction may represent the specific capabilities granted to a specific user if retrieved with that specific user's credentials, if one is in context. Servers that require authentication SHOULD still return a CapabilityStatement before authentication/authorization is performed
- RESTful clients SHOULD publish a capability statement
- The search parameters that a server supports (or a client makes use of) are specified in the resource profile that the capability statement references
- Resource Types or operations that are not listed are not supported
Messaging CapabilityStatement rules:
- The interpretation of request and response depends on the mode. If the mode is sender, then request specifies what the application sends, and response specifies what it accepts. If the mode is "receiver", then this is reversed
- If a request or response is not specified for an event, then no rules are made for it
- Events that are not listed are not supported
- The MessageDefinition resource is newly proposed and is still considered 'draft'. The supportedMessage element can be used in place of the event and the work group believes it may meet implementer needs better, however because the new mechanism has not yet been reviewed by ballot, the older 'event' mechanism has been retained. Implementers may use one or the other to define their capabilities. Feedback is welcome.
Document CapabilityStatement rules:
- Document profiles should directly constrain the Document.information.class & type elements so that there is no ambiguity concerning which profile any given document conforms to.
Other service-based use of resources: Due to the variability of these services, the CapabilityStatement resource does not attempt to describe service-based use of resources. The various service specifications will need to describe this usage in their own way.

5.3.5.1 Supporting Search

One of the most important parts of the CapabilityStatement is indicating what search functionality a server supports or a client uses. The search can specify the following things:

What resource types search is supported on, or used on
What search parameters are supported, and what their names are on this server (the server can use alternative names). Note that clients can also choose to use alternative names for search parameters, but there is no expectation that servers will adapt for the client in this regard
Servers can define their own search parameters that are not sourced from elsewhere, and often to define searches on extensions (see example)
What include and reverse includes a server supports, or a client uses
The Capability Statement does not support saying anything about modifiers or chaining directly, but these kind of statements can be made in the referenced search parameter resources (using SearchParameter.derivedFrom to establish traceability to the original definition of the search parameter)
Systems can also make statements about their use or support for system wide search (not associated with a particular resource type)

Note to Implementers: It is useful to support discovery of which reverse chaining values a server supports. Clients should not assume that servers support reverse chaining everywhere they support forward chaining. This will require a new field somewhere (e.g., in CapabilityStatement or in SearchParameter). Will review with FHIR-I, re: the best place to put this.

The most important use of support for reverse (or forward!) chaining might be in establishing conformance requirements for a server, rather than in supporting "live" discovery of a server's capabilities. (The latter could simply be tested by a client, rather than relying on possibly-incomplete or possibly-incorrect discovery data.)

Open question #1 would we want a way for servers to advertise which specific pairs of (searched resource + reverse chained search params) it support. For example, a server might need to say that the following is supported:
GET [base]/Patient?_has:Observation:subject:code=1234-5
... even though the following is not:
GET [base]/Group?_has:Observation:subject:code=1234-5
Open question #2: concern is that the possibility space is so broad that it might not be worth capturing all of this in such detail. Where to draw the line?

Note to Implementers: There is no way for a server to communicate how it supports search at this time. FHIR-I plans to address this and other search issues for R6.

5.3.5.2 Supporting Profiles

A CapabilityStatement declares two different kinds of profiles for the functionality it describes. For a discussion of the use of these two types of resources, see two uses for profiles.

5.3.6 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name	Type	Description	Expression	In Common
context	token	A use context assigned to the capability statement	(CapabilityStatement.useContext.value.ofType(CodeableConcept))	30 Resources
context-quantity	quantity	A quantity- or range-valued use context assigned to the capability statement	(CapabilityStatement.useContext.value.ofType(Quantity)) \| (CapabilityStatement.useContext.value.ofType(Range))	30 Resources
context-type TU	token	A type of use context assigned to the capability statement	CapabilityStatement.useContext.code	30 Resources
context-type-quantity TU	composite	A use context type and quantity- or range-based value assigned to the capability statement	On CapabilityStatement.useContext: context-type: code context-quantity: value.ofType(Quantity) \| value.ofType(Range)	30 Resources
context-type-value TU	composite	A use context type and value assigned to the capability statement	On CapabilityStatement.useContext: context-type: code context: value.ofType(CodeableConcept)	30 Resources
date	date	The capability statement publication date	CapabilityStatement.date	30 Resources
description	string	The description of the capability statement	CapabilityStatement.description	28 Resources
fhirversion	token	The version of FHIR	CapabilityStatement.fhirVersion
format	token	formats supported (xml \| json \| ttl \| mime type)	CapabilityStatement.format
guide	reference	Implementation guides supported	CapabilityStatement.implementationGuide (ImplementationGuide)
identifier	token	External identifier for the capability statement	CapabilityStatement.identifier	34 Resources
jurisdiction	token	Intended jurisdiction for the capability statement	CapabilityStatement.jurisdiction	26 Resources
mode	token	Mode - restful (server/client) or messaging (sender/receiver)	CapabilityStatement.rest.mode
name	string	Computationally friendly name of the capability statement	CapabilityStatement.name	26 Resources
publisher	string	Name of the publisher of the capability statement	CapabilityStatement.publisher	30 Resources
resource	token	Name of a resource mentioned in a capability statement	CapabilityStatement.rest.resource.type
resource-profile	reference	A profile id invoked in a capability statement	CapabilityStatement.rest.resource.profile (StructureDefinition)
security-service	token	OAuth \| SMART-on-FHIR \| NTLM \| Basic \| Kerberos \| Certificates	CapabilityStatement.rest.security.service
software	string	Part of the name of a software application	CapabilityStatement.software.name
status	token	The current status of the capability statement	CapabilityStatement.status	35 Resources
supported-profile TU	reference	Profiles for use cases supported	CapabilityStatement.rest.resource.supportedProfile (StructureDefinition)
title	string	The human-friendly name of the capability statement	CapabilityStatement.title	27 Resources
url	uri	The uri that identifies the capability statement	CapabilityStatement.url	34 Resources
version	token	The business version of the capability statement	CapabilityStatement.version	30 Resources