Mar 9, 2026: Source IDs Added to CommonWell Resources

We’ve added a source organization identifier tag on all new FHIR resources created from CommonWell documents. This identifier can used to determine the original source of a document using the CommonWell custodian OID and can be found in the meta.tag element of the resource.

The custodian OID represents the organization that originally authored the document. In delegated exchange scenarios, this still reflects the authoring organization.

While Carequality or TEFCA resources includes multiple identifiers (principal, home community, and repository), a CommonWell resource will have only the one custodian OID.

Example meta section:

"meta": {
  "extension": [
    {
      "url": "https://zusapi.com/data-acquisition/extension/source-binary",
      "valueReference": {
          "reference": "Binary/T3zT-f341-4cd3-a3f7-321ae356b8f3"
        }
    },
    {
      "url": "https://zusapi.com/stream",
      "valueString": "third-party"
    },
    {
      "url": "https://zusapi.com/terminology/enrichment/sha256sum",
      "valueBase64Binary": "GlVAtfE0UWOG2shd739fu48231y6jDCwRJvtLJhJ4e4="
    },
    {
      "url": "https://zusapi.com/created-at",
      "valueInstant": "2026-03-06T15:09:16.87+00:00"
    }
  ],
  "lastUpdated": "2026-03-06T15:09:16.87+00:00",
  "tag": [
    {
      "code": "commonwell",
      "system": "https://zusapi.com/thirdparty/source"
    },
    {
      "code": "2.16.840.1.999999.1.1.42",
      "system": "https://zusapi.com/data-acquisition/tag/commonwell-custodian"
    },
    {
      "code": "builder/9999aaa99-9999-999-9a99-9c99a99da9",
      "system": "https://zusapi.com/accesscontrol/owner"
    }
  ],
  "versionId": "1"
}

This change applies to resources created from March 2026 onward. Older records are not affected.