added

Oct 6, 2025: Source IDs Added to Carequality and TEFCA Resources

We’ve added source identifiers to the meta.tag element on all new FHIR resources created from Carequality and TEFCA documents.

These identifiers help clarify where each record came from and who originally created it:

  • Carequality Org ID — identifies the custodian organization that sent the data to Zus
  • Home Community ID — identifies the authoring organization that originally created the document
  • Repository ID — provides a more specific source, such as a department or repository within the authoring organization, when available

In delegated exchange scenarios, the Org ID represents the Principal organization acting for the Delegate organization, which is represented by the Home Community ID.

If there is no delegation, all three IDs will typically be the same.

This change applies only to resources created from October 2025 onward — older records won't be affected.

Example meta section:

"meta": {
  "extension": [
    {
      "url": "https://zusapi.com/stream",
      "valueString": "third-party"
    },
    {
      "url": "https://zusapi.com/terminology/enrichment/sha256sum",
      "valueBase64Binary": "GlVAtfE0UWOG2shd739fu48231y6jDCwRJvtLJhJ4e4="
    },
    {
      "url": "https://zusapi.com/created-at",
      "valueInstant": "2025-10-06T15:09:16.87+00:00"
    }
  ],
  "lastUpdated": "2025-10-06T15:09:16.87+00:00",
  "tag": [
    {
      "code": "carequality",
      "system": "https://zusapi.com/thirdparty/source"
    },
    {
      "code": "2.16.840.1.999999.1.1.42",
      "system": "https://zusapi.com/data-acquisition/tag/carequality-org-id"
    },
    {
      "code": "2.16.840.1.999999.2.14.3001",
      "system": "https://zusapi.com/data-acquisition/tag/carequality-home-community-id"
    },
    {
      "code": "2.16.840.1.999999.2.14.3001.12",
      "system": "https://zusapi.com/data-acquisition/tag/carequality-repository-id"
    },
    {
      "code": "builder/9999aaa99-9999-999-9a99-9c99a99da9",
      "system": "https://zusapi.com/accesscontrol/owner"
    }
  ],
  "versionId": "1"
}

What We’re Working on Next

  • Extending the same tagging approach to CommonWell documents.
  • Adding these source identifiers as columns in the data marts.