Skip to main content

CapabilityStatement

ResourceFoundation · ConformanceNormativeMaturity 5

A Capability Statement documents a set of capabilities (behaviors) of a FHIR Server 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.

Tested supportFull test results →
Backends
PostgreSQLElasticsearch
Interactions
CreateReadUpdatePatchDelete
Search
18 of 23 parameters tested

Structure​

ElementCard.TypeDescription
urlΣ
0..1uriCanonical identifier for this capability statement, represented as a URI (globally unique)
versionΣ
0..1stringBusiness version of the capability statement
nameΣ
0..1stringName for this capability statement (computer friendly)
titleΣ
0..1stringName for this capability statement (human friendly)
statusRequired?!Σ
1..1codedraft | active | retired | unknownBinding (required): publication-status
experimentalΣ
0..1booleanFor testing purposes, not real usage
dateRequiredΣ
1..1dateTimeDate last changed
publisherΣ
0..1stringName of the publisher (organization or individual)
contactΣ
0..*ContactDetailContact details for the publisher
description
0..1markdownNatural language description of the capability statement
useContextΣ
0..*UsageContextThe context that the content is intended to support
jurisdictionΣ
0..*CodeableConceptIntended jurisdiction for capability statement (if applicable)Binding (extensible): jurisdiction
purpose
0..1markdownWhy this capability statement is defined
copyright
0..1markdownUse and/or publishing restrictions
kindRequiredΣ
1..1codeinstance | capability | requirementsBinding (required): capability-statement-kind
instantiatesΣ
0..*canonical(CapabilityStatement)Canonical URL of another capability statement this implements
importsΣ
0..*canonical(CapabilityStatement)Canonical URL of another capability statement this adds to
softwareΣ
0..1BackboneElementSoftware that is covered by this capability statement
nameRequiredΣ
1..1stringA name the software is known by
versionΣ
0..1stringVersion covered by this statement
releaseDateΣ
0..1dateTimeDate this version was released
implementationΣ
0..1BackboneElementIf this describes a specific instance
descriptionRequiredΣ
1..1stringDescribes this specific instance
urlΣ
0..1urlBase URL for the installation
custodianΣ
0..1Reference(Organization)Organization that manages the data
fhirVersionRequiredΣ
1..1codeFHIR Version the system supportsBinding (required): FHIR-version
formatRequiredΣ
1..*codeformats supported (xml | json | ttl | mime type)Binding (required): mimetypes
patchFormatΣ
0..*codePatch formats supportedBinding (required): mimetypes
implementationGuideΣ
0..*canonical(ImplementationGuide)Implementation guides supported
restΣ
0..*BackboneElementIf the endpoint is a RESTful one
modeRequiredΣ
1..1codeclient | serverBinding (required): restful-capability-mode
documentation
0..1markdownGeneral description of implementation
securityΣ
0..1BackboneElementInformation about security of implementation
corsΣ
0..1booleanAdds CORS Headers (http://enable-cors.org/)
serviceΣ
0..*CodeableConceptOAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | CertificatesBinding (extensible): restful-security-service
description
0..1markdownGeneral description of how security works
resourceΣ
0..*BackboneElementResource served on the REST interface
typeRequiredΣ
1..1codeA resource type that is supportedBinding (required): resource-types
profileΣ
0..1canonical(StructureDefinition)Base System profile for all uses of resource
supportedProfileΣ
0..*canonical(StructureDefinition)Profiles for use cases supported
documentation
0..1markdownAdditional information about the use of the resource type
interaction
0..*BackboneElementWhat operations are supported?
codeRequired
1..1coderead | vread | update | patch | delete | history-instance | history-type | create | search-typeBinding (required): type-restful-interaction
documentation
0..1markdownAnything special about operation behavior
versioning
0..1codeno-version | versioned | versioned-updateBinding (required): versioning-policy
readHistory
0..1booleanWhether vRead can return past versions
updateCreate
0..1booleanIf update can commit to a new identity
conditionalCreate
0..1booleanIf allows/uses conditional create
conditionalRead
0..1codenot-supported | modified-since | not-match | full-supportBinding (required): conditional-read-status
conditionalUpdate
0..1booleanIf allows/uses conditional update
conditionalDelete
0..1codenot-supported | single | multiple - how conditional delete is supportedBinding (required): conditional-delete-status
referencePolicy
0..*codeliteral | logical | resolves | enforced | localBinding (required): reference-handling-policy
searchInclude
0..*string_include values supported by the server
searchRevInclude
0..*string_revinclude values supported by the server
searchParam
0..*BackboneElementSearch parameters supported by implementation
nameRequired
1..1stringName of search parameter
definition
0..1canonical(SearchParameter)Source of definition for parameter
typeRequired
1..1codenumber | date | string | token | reference | composite | quantity | uri | specialBinding (required): search-param-type
documentation
0..1markdownServer-specific usage
operationΣ
0..*BackboneElementDefinition of a resource operation
nameRequiredΣ
1..1stringName by which the operation/query is invoked
definitionRequiredΣ
1..1canonical(OperationDefinition)The defined operation/query
documentation
0..1markdownSpecific details about operation behavior
interaction
0..*BackboneElementWhat operations are supported?
codeRequired
1..1codetransaction | batch | search-system | history-systemBinding (required): system-restful-interaction
documentation
0..1markdownAnything special about operation behavior
searchParam
0..*Same as CapabilityStatement.rest.resource.searchParamSearch parameters for searching all resources
operationΣ
0..*Same as CapabilityStatement.rest.resource.operationDefinition of a system level operation
compartment
0..*canonical(CompartmentDefinition)Compartments served/used by system
messagingΣ
0..*BackboneElementIf messaging is supported
endpoint
0..*BackboneElementWhere messages should be sent
protocolRequired
1..1Codinghttp | ftp | mllp +Binding (extensible): message-transport
addressRequired
1..1urlNetwork address or identifier of the end-point
reliableCache
0..1unsignedIntReliable Message Cache Length (min)
documentation
0..1markdownMessaging interface behavior details
supportedMessageΣ
0..*BackboneElementMessages supported by this system
modeRequiredΣ
1..1codesender | receiverBinding (required): event-capability-mode
definitionRequiredΣ
1..1canonical(MessageDefinition)Message supported by this system
documentΣ
0..*BackboneElementDocument definition
modeRequiredΣ
1..1codeproducer | consumerBinding (required): document-mode
documentation
0..1markdownDescription of document support
profileRequiredΣ
1..1canonical(StructureDefinition)Constraint on the resources used in the document

Σ in _summary results · ?! modifier element · 1.. required · inherited elements in grey

Search parameters​

Query with GET [base]/CapabilityStatement?[parameter]=[value]. Type decides which modifiers and prefixes apply, see search features.

ParameterTypeDescriptionPGES
contexttoken

A use context assigned to the capability statement

(CapabilityStatement.useContext.value.ofType(CodeableConcept))
context-quantityquantity

A quantity- or range-valued use context assigned to the capability statement

(CapabilityStatement.useContext.value.ofType(Quantity)) | (CapabilityStatement.useContext.value.ofType(Range))
context-typetoken

A type of use context assigned to the capability statement

CapabilityStatement.useContext.code
context-type-quantitycomposite

A use context type and quantity- or range-based value assigned to the capability statement

CapabilityStatement.useContext
context-type-valuecomposite

A use context type and value assigned to the capability statement

CapabilityStatement.useContext
datedate

The capability statement publication date

CapabilityStatement.date
descriptionstring

The description of the capability statement

CapabilityStatement.description
fhirversiontoken

The version of FHIR

CapabilityStatement.version
formattoken

formats supported (xml | json | ttl | mime type)

CapabilityStatement.format
guidereference

Implementation guides supported

CapabilityStatement.implementationGuide
jurisdictiontoken

Intended jurisdiction for the capability statement

CapabilityStatement.jurisdiction
modetoken

Mode - restful (server/client) or messaging (sender/receiver)

CapabilityStatement.rest.mode
namestring

Computationally friendly name of the capability statement

CapabilityStatement.name
publisherstring

Name of the publisher of the capability statement

CapabilityStatement.publisher
resourcetoken

Name of a resource mentioned in a capability statement

CapabilityStatement.rest.resource.type
resource-profilereference

A profile id invoked in a capability statement

CapabilityStatement.rest.resource.profile
security-servicetoken

OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates

CapabilityStatement.rest.security.service
softwarestring

Part of the name of a software application

CapabilityStatement.software.name
statustoken

The current status of the capability statement

CapabilityStatement.status
supported-profilereference

Profiles for use cases supported

CapabilityStatement.rest.resource.supportedProfile
titlestring

The human-friendly name of the capability statement

CapabilityStatement.title
urluri

The uri that identifies the capability statement

CapabilityStatement.url
versiontoken

The business version of the capability statement

CapabilityStatement.version

PG: PostgreSQL, ES: Elasticsearch. passes its TestScript checks, fails, not tested yet.

Common parameters on every resource (8)
_haste-health-authorreference

The author of the resource

_idtoken

Logical id of this artifact

_lastUpdateddate

When the resource version last changed

_profileuri

Profiles this resource claims to conform to

_securitytoken

Security Labels applied to this resource

_sourceuri

Identifies where the resource comes from

_tagtoken

Tags applied to this resource

_typetoken

Derived from the R4B Definition