A capability statement is a set of capabilities of a FHIR Server that may be used as a statement of actual server functionality or a statement of required or desired server implementation.

0. References

1. Read

The /metadata path on the root of the FHIR server will return the Capability statement for the FHIR server:

Alternatively, a HTTP OPTIONS request against the root of the FHIR server will also return the capability profile:

For details of this interaction - see the HL7 FHIR STU3 RESTful API

All requests SHALL contain a valid ‘Authorization’ header and SHALL contain an ‘Accept’ header with at least one of the following application/json+fhir or application/xml+fhir.

2. Example

2.1 Request Query

Retrieve the Capability statement from the FHIR Server, the format of the response body will be xml. Replace ‘baseUrl’ with the actual base Url of the FHIR Server.

2.1.1. cURL

curl -X GET -H 'Accept: application/xml+fhir' -H 'Authorization: BEARER [token]' -v 'http://yellow.testlab.nhs.uk/careconnect/STU3/metadata?'

2.2 Response Body

2.3 C#

var client = new FhirClient("http://[fhir_base]/");
client.PreferredFormat = ResourceFormat.Json;
var resource = client.Conformance();
FhirSerializer.SerializeResourceToXml(resource).Dump();