Bulk Data Access IG
4.0.0 - STU 4 International flag

Bulk Data Access IG, published by HL7 International / FHIR Infrastructure. This guide is not an authorized publication; it is the continuous build for version 4.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/bulk-data/ and changes regularly. See the Directory of published versions

: Bulk Publish Capability Statement

Page standards status: Trial-use Maturity Level: 2

Raw json | Download

{
  "resourceType" : "CapabilityStatement",
  "id" : "bulk-publish",
  "language" : "en",
  "text" : {
    "status" : "extensions",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CapabilityStatement bulk-publish</b></p><a name=\"bulk-publish\"> </a><a name=\"hcbulk-publish\"> </a><h2 id=\"title\">Bulk Publish Capability Statement</h2><ul><li>Implementation Guide Version: 4.0.0 </li><li>FHIR Version: 4.0.1 </li><li>Supported Formats: <code>application/fhir+json</code></li><li>Published on: 2026-11-06 </li><li>Published by: HL7 International / FHIR Infrastructure </li></ul><blockquote class=\"impl-note\"><p><strong>Note to Implementers: FHIR Capabilities</strong></p><p>Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.</p></blockquote><h3 id=\"shallIGs\">SHALL Support the Following Implementation Guides</h3><ul><li><a href=\"index.html\">http://hl7.org/fhir/uv/bulkdata/ImplementationGuide/hl7.fhir.uv.bulkdata</a></li></ul><h2 id=\"rest\">FHIR RESTful Capabilities</h2><div class=\"panel panel-default\"><div class=\"panel-heading\"><h3 id=\"mode1\" class=\"panel-title\">Mode: <code>server</code></h3></div><div class=\"panel-body\"><div><p>This FHIR Operation returns a Bulk Publish manifest with links to Bulk Data files that the Data Provider has published. See <a href=\"publish.html\">Bulk Publish</a>.</p>\n</div><div class=\"lead\"><em>Security</em></div><blockquote><div><p>Data Providers MAY implement OAuth 2.0 access management in accordance with the <a href=\"authorization.html\">SMART Backend Services Authorization Profile</a>. Implementations MAY use authorization schemes other than OAuth 2.0, such as mutual TLS or capability URLs.</p>\n</div></blockquote><div class=\"row\"><div class=\"col-12\"><span class=\"lead\">Summary of System-wide Operations</span><table class=\"table table-condensed table-hover\"><thead><tr><th>Conformance</th><th>Operation</th><th>Documentation</th></tr></thead><tbody><tr><td><b>SHALL</b></td><td><a href=\"OperationDefinition-bulk-publish.html\">$bulk-publish</a></td><td><div><p>FHIR Operation invoked with an HTTP GET request to retrieve a Bulk Publish manifest.</p>\n</div></td></tr></tbody></table></div></div></div></div></div>"
  },
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger" : 2
    },
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode" : "fhir"
    },
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode" : "trial-use",
      "_valueCode" : {
        "extension" : [
          {
            "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical" : "http://hl7.org/fhir/uv/bulkdata/ImplementationGuide/hl7.fhir.uv.bulkdata"
          }
        ]
      }
    }
  ],
  "url" : "http://hl7.org/fhir/uv/bulkdata/CapabilityStatement/bulk-publish",
  "version" : "4.0.0",
  "name" : "BulkPublishCapabilityStatement",
  "title" : "Bulk Publish Capability Statement",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-11-06",
  "publisher" : "HL7 International / FHIR Infrastructure",
  "contact" : [
    {
      "name" : "HL7 International / FHIR Infrastructure",
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://www.hl7.org/Special/committees/fiwg"
        },
        {
          "system" : "email",
          "value" : "fhir@lists.HL7.org"
        }
      ]
    }
  ],
  "description" : "The expected capabilities of a Data Provider actor that publishes Bulk Data files for retrieval by Data Consumers using the `$bulk-publish` operation. Systems implementing this capability statement SHOULD meet the Bulk Publish requirements set by the Bulk Data Access Implementation Guide.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code" : "001"
        }
      ]
    }
  ],
  "kind" : "requirements",
  "fhirVersion" : "4.0.1",
  "format" : [
    "application/fhir+json"
  ],
  "implementationGuide" : [
    🔗 "http://hl7.org/fhir/uv/bulkdata/ImplementationGuide/hl7.fhir.uv.bulkdata"
  ],
  "rest" : [
    {
      "mode" : "server",
      "documentation" : "This FHIR Operation returns a Bulk Publish manifest with links to Bulk Data files that the Data Provider has published. See [Bulk Publish](publish.html).",
      "security" : {
        "description" : "Data Providers MAY implement OAuth 2.0 access management in accordance with the [SMART Backend Services Authorization Profile](authorization.html). Implementations MAY use authorization schemes other than OAuth 2.0, such as mutual TLS or capability URLs."
      },
      "operation" : [
        {
          "extension" : [
            {
              "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
              "valueCode" : "SHALL"
            }
          ],
          "name" : "bulk-publish",
          "definition" : "http://hl7.org/fhir/uv/bulkdata/OperationDefinition/bulk-publish",
          "documentation" : "FHIR Operation invoked with an HTTP GET request to retrieve a Bulk Publish manifest."
        }
      ]
    }
  ]
}