Core Concepts

Provenance Chains

Every assertion carries its full origin story. When a raw hemoglobin value is normalized to LOINC 718-7, then classified as moderate anemia, then fed into an AI model — each step is recorded. You always know where data came from and how it was transformed.

Hemoglobin 9.2 g/dL — transformation history

Source Fact

9.2 g/dL

Raw result · Quest Diagnostics · HL7v2

Normalized

LOINC 718-7: 9.2 g/dL

Mapped to standard terminology

Derived

Anemia: moderate

Classified from reference range

Model Output

Treatment response: 73% likely

AI prediction · confidence 0.81

Source

Normalized

Derived

Model

Fetching a provenance chain

typescript

const chain = await client.provenance.chain('assertion-id-here');
// → {
//     assertionId: string,
//     steps: [
//       {
//         layer: 'source_fact',
//         sourceSystemId: 'quest-diagnostics',
//         sourceRecordId: 'ORU-20250315-001',
//         protocol: 'HL7v2',
//         timestamp: '2025-03-15T09:11:00Z',
//         rawPayload: { ... }
//       },
//       {
//         layer: 'normalized_fact',
//         transformedBy: 'loinc-mapper-v2',
//         mappedCode: 'LOINC:718-7',
//         timestamp: '2025-03-15T09:11:04Z'
//       }
//     ]
//   }