Clinia
How-to Guides

Review the Reconciliation Summary

Read the reconciliation report to see pipeline stats and inferred relationships.

Review the Reconciliation Summary

The reconciliation summary gives a higher-level view of pipeline activity than the full resolution report. It covers how many entities were merged, which source records were collapsed into each one, and which relationships the pipeline inferred rather than read from the source data.

Fetch as Markdown

The default response is a human-readable Markdown report:

curl "https://<workspace-id>.w.clinia.cloud/v1/patients/{patientId}/reconciliation" \
  -H "Authorization: Bearer <access-token>"
# Reconciliation Summary - Jeanne Tremblay

## Pipeline Stats
- Input entities: 24
- Resolved entities: 21 (3 groups merged)
- Explicit relationships: 11
- Inferred relationships: 17

## Merged Entity Groups
- Chronic obstructive lung disease (condition): 2 sources, matched by deterministic-code (0.97)
- Tiotropium 18mcg daily (medication): 2 sources, matched by nlp-normalization (0.85)
- FEV1 (lab): 2 sources, matched by embedding-similarity (0.91)

## Inferred Relationships
- tiotropium → prescribed_for → chronic_obstructive_lung_disease (0.94)
- fev1 → monitors → chronic_obstructive_lung_disease (0.96)
- chronic_obstructive_lung_disease → has_complication → acute_exacerbation_of_copd (0.92)

Fetch as JSON

For programmatic access, append ?format=json:

curl "https://<workspace-id>.w.clinia.cloud/v1/patients/{patientId}/reconciliation?format=json" \
  -H "Authorization: Bearer <access-token>"

The JSON response has four sections: patientName, stats, mergedEntities, and inferredRelationships.

Understanding inferred relationships

Inferred relationships come from the clinical knowledge base, they are not present in the source records. The pipeline adds them in Phase 2 of the resolution pipeline.

Common inferred types:

RelationshipExample
prescribed_formetformin → type_2_diabetes
monitorshba1c → type_2_diabetes
has_complicationtype_2_diabetes → ckd
risk_factor_forhyperlipidemia → cad

These relationships are what powers condition stories, the "Current Treatment" and "Monitoring Labs" tables come from prescribed_for and monitors edges, and the "Complications" section comes from has_complication edges.

Comparing to the full resolution report

ReconciliationResolution
ScopeSummary stats + merge groupsEvery entity with full provenance
Inferred relationships✓ Listed✗ Not included
Conflict detail✗ Not included✓ Full field-by-field conflicts
Good forUnderstanding what happened overallDebugging a specific entity

See Audit Entity Resolution for per-entity provenance detail.

On this page