Skip to content

Provenance Profile

Canonicalhttps://fhir.apps.health/StructureDefinition/nexus-emr-core-provenance
Statusdraft · 1.33.0
BaseProvenance (constraint)
SourceFSH · JSON

Attribution for AI-mediated writes, cross-boundary writes and record-lifecycle events such as linking an arriving result to a chart or entering a resource into the record: what was produced, when, by which agent (human or non-human), from what inputs, and -- for generated text -- which verbatim source passage each statement rests on. Used standalone against a produced resource, and contained in an AI-suggestion review Task against the suggestion contained alongside it.

Examples

AI-Drafted Note Accepted by a Clinician · AI-Generated Summary With Per-Fact Citations · Import Provenance for a Migration File · Prov lab link automatic inr 20250402 · Prov lab link confirmed cbc 20250408 · Prov lab link manual us 20260312 · Prov lab unlink manual cbc 20250409

Prov lab unlink manual cbc 20250409

Provenance/prov-lab-unlink-manual-cbc-20250409 — claims conformance to Provenance Profile

{
  "resourceType": "Provenance",
  "id": "prov-lab-unlink-manual-cbc-20250409",
  "meta": {
    "profile": [
      "https://fhir.apps.health/StructureDefinition/nexus-emr-core-provenance"
    ]
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns='http://www.w3.org/1999/xhtml'><p>Provenance for correcting a misfiled result: the CBC the matcher proposed and a nurse accepted turned out to belong to another patient, and a nurse unlinked it from this chart.</p><p>Activity <code>unlink</code>, link method <code>manual</code>. The target is the version the unlink produced, so the version before it still shows which chart the result left. Linking it to the right chart is a separate Provenance with its own method.</p></div>"
  },
  "target": [
    {
      "reference": "DiagnosticReport/anemia-diagnosticreport-20250408/_history/2",
      "display": "CBC panel, 2025-04-08"
    }
  ],
  "occurredDateTime": "2025-04-09T09:05:00-06:00",
  "recorded": "2025-04-09T09:05:03-06:00",
  "activity": {
    "extension": [
      {
        "url": "https://fhir.apps.health/StructureDefinition/nexus-link-method",
        "valueCoding": {
          "system": "https://fhir.apps.health/CodeSystem/nexus-link-method",
          "code": "manual",
          "display": "Linked by a person"
        }
      }
    ],
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/iso-21089-lifecycle",
        "code": "unlink",
        "display": "Unlink Record Lifecycle Event"
      }
    ],
    "text": "Filed to the wrong chart: date of birth matched, name did not on review"
  },
  "agent": [
    {
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
            "code": "author",
            "display": "Author"
          }
        ],
        "text": "Unlinked the result from the wrong chart"
      },
      "who": {
        "reference": "Practitioner/adaeze-okonkwo-rn",
        "display": "Adaeze Okonkwo, RN"
      }
    }
  ]
}