Visit the HL7 website
Visit the FHIR website

Pan-Canadian FHIR Exchange (CA:FeX) IGuide

2.2.0-DFT   Canada flag
  • Home
  • Business Context
    • Project Background
    • Scope
    • Relationship to Other Specifications
    • Use Cases
  • Technical Context
    • Overview
    • FHIR Exchange Paradigms
    • Data Exchange
    • Document Exchange
    • RESTful API Interactions
    • Sequence Diagrams
    • Actor Mapping to Interoperability Specification
    • Security
  • Actor and Conformance Options
    • Technical Actors
    • Actor Options
    • Conformance Requirements
  • FHIR Artifacts
    • Profiles and Extensions
    • Search Parameters
    • Operations
    • Capability Statements
    • Capability Statements - Server
  • Change Log
    • Change Log
    1. Home
    2. FHIR Artifacts
    3. Capability Statements
    4. CA:FeX CapabilityStatement - Data Source - Option B (Metadata)

DFT Ballot - This specification is currently in ballot review and subject to change. It is not ready for limited roll-out or production level use. For a full list of available versions, see the Directory of published versions

CA:FeX CapabilityStatement - Data Source - Option B (Metadata)

  • Overview
  • Tree view
  • XML
  • JSON

REST Capabilities Client

ModeClient
Documentation

This client supports CA:FeX-1B – submission of DocumentReference resources (for searchable metadata) and associated content (such as Binary or Bundle resources) to a Data Recipient to enable metadata-based document discovery.

Security

Description
  1. See the security section of the CA:FeX guide for security requirements and recommendations.
  2. A server SHALL reject any unauthorized requests by returning an HTTP 401 "Unauthorized", HTTP 403 "Forbidden", or HTTP 404 "Not Found"

Resource Interactions

Resource TypeSupported ProfilesCreateUpdatePatchDelete
DocumentReferenceSHOULDMAYMAYMAY

Operations per resource type

DocumentReference

OperationReferenceLevel
$generate-metadata??SHALL
CapabilityStatement
id : CaFeX-DataSource-Option-B
url : http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataSource-Option-B
title : CA:FeX CapabilityStatement - Data Source - Option B (Metadata)
description : CA:FeX-1B – Conformance expectations for a CA:FeX Data Source implementing Metadata Option (B). The system must support submission and management of DocumentReference and Binary resources for metadata-based discovery.
status : draft
version : 2.2.0
name : CAFEX_DataSource_Option_B
date : 2025-04-01
kind : requirements
experimental : False
fhirVersion : 4.0.1
format : json
format : xml
jurisdiction
coding
code : CA
system : urn:iso:std:iso:3166
publisher : Canada Health Infoway
contact
name : National Standards Release Centre
telecom
system : url
value : http://www.infoway-inforoute.ca
telecom
system : email
value : standards@infoway-inforoute.ca
copyright : Copyright © 2021–2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy).
rest
mode : client
documentation : This client supports CA:FeX-1B – submission of DocumentReference resources (for searchable metadata) and associated content (such as Binary or Bundle resources) to a Data Recipient to enable metadata-based document discovery.
security
description : 1. See the security section of the CA:FeX guide for security requirements and recommendations. 2. A server **SHALL** reject any unauthorized requests by returning an `HTTP 401` "Unauthorized", `HTTP 403` "Forbidden", or `HTTP 404` "Not Found"
resource
type : DocumentReference
operation
name : $generate-metadata
definition : http://fhir.infoway-inforoute.ca/io/cafex/OperationDefinition/generate-metadata
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : SHALL
interaction
code : create
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : SHOULD
interaction
code : update
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
interaction
code : patch
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
interaction
code : delete
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
<CapabilityStatement xmlns="http://hl7.org/fhir">
<id value="CaFeX-DataSource-Option-B" />
<url value="http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataSource-Option-B" />
<version value="2.2.0" />
<name value="CAFEX_DataSource_Option_B" />
<title value="CA:FeX CapabilityStatement - Data Source - Option B (Metadata)" />
<status value="draft" />
<experimental value="false" />
<date value="2025-04-01" />
<publisher value="Canada Health Infoway" />
<contact>
<name value="National Standards Release Centre" />
<telecom>
<system value="url" />
<value value="http://www.infoway-inforoute.ca" />
</telecom>
<telecom>
<system value="email" />
<value value="standards@infoway-inforoute.ca" />
</telecom>
</contact>
<description value="CA:FeX-1B – Conformance expectations for a CA:FeX Data Source implementing Metadata Option (B). The system must support submission and management of DocumentReference and Binary resources for metadata-based discovery." />
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166" />
<code value="CA" />
</coding>
</jurisdiction>
<copyright value="Copyright © 2021–2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy)." />
<kind value="requirements" />
<fhirVersion value="4.0.1" />
<format value="json" />
<format value="xml" />
<rest>
<mode value="client" />
<documentation value="This client supports CA:FeX-1B – submission of DocumentReference resources (for searchable metadata) and associated content (such as Binary or Bundle resources) to a Data Recipient to enable metadata-based document discovery." />
<security>
<description value="1. See the security section of the CA:FeX guide for security requirements and recommendations.\n2. A server **SHALL** reject any unauthorized requests by returning an `HTTP 401` "Unauthorized", `HTTP 403` "Forbidden", or `HTTP 404` "Not Found"" />
</security>
<resource>
<type value="DocumentReference" />
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD" />
</extension>
<code value="create" />
</interaction>
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY" />
</extension>
<code value="update" />
</interaction>
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY" />
</extension>
<code value="patch" />
</interaction>
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY" />
</extension>
<code value="delete" />
</interaction>
<operation>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL" />
</extension>
<name value="$generate-metadata" />
<definition value="http://fhir.infoway-inforoute.ca/io/cafex/OperationDefinition/generate-metadata" />
</operation>
</resource>
</rest>
</CapabilityStatement>
{
"resourceType": "CapabilityStatement",
"id": "CaFeX-DataSource-Option-B",
"url": "http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataSource-Option-B",
"title": "CA:FeX CapabilityStatement - Data Source - Option B (Metadata)",
"description": "CA:FeX-1B – Conformance expectations for a CA:FeX Data Source implementing Metadata Option (B). The system must support submission and management of DocumentReference and Binary resources for metadata-based discovery.",
"status": "draft",
"version": "2.2.0",
"name": "CAFEX_DataSource_Option_B",
"date": "2025-04-01",
"kind": "requirements",
"experimental": false,
"fhirVersion": "4.0.1",
"format": [
"json",
"xml"
],
"jurisdiction": [
{
"coding": [
{
"code": "CA",
"system": "urn:iso:std:iso:3166"
}
]
}
],
"publisher": "Canada Health Infoway",
"contact": [
{
"name": "National Standards Release Centre",
"telecom": [
{
"system": "url",
"value": "http://www.infoway-inforoute.ca"
},
{
"system": "email",
"value": "standards@infoway-inforoute.ca"
}
]
}
],
"copyright": "Copyright © 2021–2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy).",
"rest": [
{
"mode": "client",
"documentation": "This client supports CA:FeX-1B – submission of DocumentReference resources (for searchable metadata) and associated content (such as Binary or Bundle resources) to a Data Recipient to enable metadata-based document discovery.",
"security": {
"description": "1. See the security section of the CA:FeX guide for security requirements and recommendations.\n2. A server **SHALL** reject any unauthorized requests by returning an `HTTP 401` \"Unauthorized\", `HTTP 403` \"Forbidden\", or `HTTP 404` \"Not Found\""
},
"resource": [
{
"type": "DocumentReference",
"operation": [
{
"name": "$generate-metadata",
"definition": "http://fhir.infoway-inforoute.ca/io/cafex/OperationDefinition/generate-metadata",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}
]
}
],
"interaction": [
{
"code": "create",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
]
},
{
"code": "update",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "MAY"
}
]
},
{
"code": "patch",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "MAY"
}
]
},
{
"code": "delete",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "MAY"
}
]
}
]
}
]
}
]
}

IG © based on FHIR R4 | Package package:ca.infoway.io.cafex@2.2.0-DFT
HL7® and FHIR® are the registered trademarks of Health Level Seven International