Skip to main content

Provenance

Trial Use 4 Foundation

Provenance of a resource is a record that describes entities and processes involved in producing and delivering or otherwise influencing that resource. Provenance provides a critical foundation for assessing authenticity, enabling trust, and allowing reproducibility. Provenance assertions are a form of contextual metadata and can themselves become important records with their own provenance. Provenance statement indicates clinical significance in terms of confidence in authenticity, reliability, and trustworthiness, integrity, and stage in lifecycle (e.g. Document Completion - has the artifact been legally authenticated), all of which may impact security, privacy, and trust policies.

Endpoints

devhttps://api.sandbox.ovok.com/fhir/R5/Provenance
InteractionMethodPath
ReadGET/fhir/R5/Provenance/[id]
VreadGET/fhir/R5/Provenance/[id]/_history/[vid]
UpdatePUT/fhir/R5/Provenance/[id]
PatchPATCH/fhir/R5/Provenance/[id]
DeleteDELETE/fhir/R5/Provenance/[id]
CreatePOST/fhir/R5/Provenance
SearchGET/fhir/R5/Provenance?...
HistoryGET/fhir/R5/Provenance/[id]/_history
Type-historyGET/fhir/R5/Provenance/_history

Top-level elements

ElementType(s)CardinalityDescription
targetReference1..*Target Reference(s) (usually version specific)
occurred[x]Period / dateTime0..1When the activity occurred
recordedinstant0..1When the activity was recorded / updated
policyuri0..*Policy or plan the activity was defined by
locationReference0..1Where the activity occurred, if relevant
authorizationCodeableReference0..*Authorization (purposeOfUse) related to the event
activityCodeableConcept0..1Activity that occurred
basedOnReference0..*Workflow authorization within which this event occurred
patientReference0..1The patient is the subject of the data created/updated (.target) by the activity
encounterReference0..1Encounter within which this event occurred or which the event is tightly associated
agentBackboneElement1..*Actor involved
entityBackboneElement0..*An entity used in this activity
signatureSignature0..*Signature on target

Resource-specific search parameters

ParameterTypeDescription
activitytokenActivity that occurred
agentreferenceWho participated
agent-roletokenWhat the agents role was
agent-typetokenHow the agent participated
based-onreferenceReference to the service request.
encounterreferenceEncounter related to the activity recorded in the AuditEvent
entityreferenceIdentity of entity
locationreferenceWhere the activity occurred, if relevant
patientreferenceThe entity that caused the expenses
recordeddateWhen the activity was recorded / updated
signature-typetokenIndication of the reason the entity signed the object(s)
targetreferenceTarget Reference(s) (usually version specific)
whendateWhen the activity occurred

Reference

  • Official FHIR R5 spec: Provenance
  • Maturity: Trial Use 4 (FMM 4).