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 link confirmed cbc 20250408

Provenance/prov-lab-link-confirmed-cbc-20250408 — claims conformance to Provenance Profile

{
  "resourceType": "Provenance",
  "id": "prov-lab-link-confirmed-cbc-20250408",
  "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 a lab result the matcher proposed and a person accepted: the lab inbound matcher found a probable chart for a CBC result, and a nurse confirmed it.</p><p>Link method (the <code>nexus-link-method</code> extension on <code>activity</code>) <code>confirmed</code>. Both agents are named: the matcher as author, the nurse who accepted the proposal as verifier.</p></div>"
  },
  "target": [
    {
      "reference": "DiagnosticReport/anemia-diagnosticreport-20250408/_history/1",
      "display": "CBC panel, 2025-04-08"
    }
  ],
  "occurredDateTime": "2025-04-08T11:20:00-06:00",
  "recorded": "2025-04-08T11:20:02-06:00",
  "activity": {
    "extension": [
      {
        "url": "https://fhir.apps.health/StructureDefinition/nexus-link-method",
        "valueCoding": {
          "system": "https://fhir.apps.health/CodeSystem/nexus-link-method",
          "code": "confirmed",
          "display": "Proposed by a matcher, accepted by a person"
        }
      }
    ],
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/iso-21089-lifecycle",
        "code": "link",
        "display": "Link Record Lifecycle Event"
      }
    ],
    "text": "Probable match on name and date of birth; health card number absent from the result"
  },
  "agent": [
    {
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
            "code": "author",
            "display": "Author"
          }
        ],
        "text": "Matching service that proposed the chart"
      },
      "who": {
        "type": "Device",
        "identifier": {
          "system": "https://fhir.apps.health/NamingSystem/nexus-automation",
          "value": "lab-inbound-matcher"
        },
        "display": "Lab inbound matcher"
      }
    },
    {
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
            "code": "verifier",
            "display": "Verifier"
          }
        ],
        "text": "Accepted the proposed chart"
      },
      "who": {
        "reference": "Practitioner/adaeze-okonkwo-rn",
        "display": "Adaeze Okonkwo, RN"
      }
    }
  ]
}