Query claims like a medical record.
Flexpa derives US Core Encounter, Condition and Procedure resources from a patient's adjudicated claims, so health plan data works with the clinical queries and tools you already have.
Included from Scale · $5,000/year on lower plans · Read the docs
- ExplanationOfBenefit
- Encounter
- Condition
- Procedure
- Provenance
01The short answer
What is claims to clinical data normalization?
Health insurers share claims as FHIR ExplanationOfBenefit resources. Claims carry real clinical signal (diagnoses, procedures, providers and dates of service), but they are financial records, and most clinical tooling expects Encounter, Condition and Procedure.
This add-on runs a deterministic pipeline that creates those resources from each claim and adds them to the patient's data next to the original claims. Every generated resource carries a claims-derived extension and a Provenance link back to the source claim, so you always know where it came from.
02How it works
From connection to result
- 1
Filter the claims
Cancelled, draft and entered-in-error claims are skipped. Pharmacy claims do not produce encounters.
- 2
Generate conditions and procedures
One Condition per diagnosis, with ICD-10 or SNOMED coding, and one Procedure per procedure, with CPT or HCPCS coding.
- 3
Generate the encounter
One Encounter per eligible claim unless a matching one already exists, with its class (ambulatory, inpatient, emergency and more) worked out from place of service, revenue codes and type of bill.
- 4
Link it all back
A Provenance resource ties every generated resource to its claim. IDs are deterministic, so re-syncing the same claim produces the same resources.
{
"resourceType": "Encounter",
"meta": {
"profile": ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter"]
},
"extension": [
{
"url": "https://api.flexpa.com/fhir/StructureDefinition/claims-derived",
"valueBoolean": true
}
]
}Good to know
- Generation runs on payer endpoints Flexpa has identified as missing clinical resources. Where an insurer already returns them, you get theirs.
- The original claims stay in the record, untouched.
- Pharmacy claims do not produce encounters, and conditions or procedures from them are discarded.
- Payers can license the engine for their own claims data. Email partnerships@flexpa.com.
03Who it's for
Where it pays off
Clinical research
Inclusion and exclusion criteria are written in diagnoses and procedures. Screen against them directly.
See clinical researchValue-based care
Stratify risk from a new patient’s history on day one with conditions and encounters, not billing lines.
Read the guidePayers
The same engine is available as a standalone transformer for payers implementing the Da Vinci PDex mappings.
See payersPlans
Included in Scale and above
Claims to clinical data normalization is included in the Scale, Omni and Infrastructure plans. On Startup and Growth, it is $5,000 a year.
04A few good questions
Claims to clinical data normalization,
answered.
Do we lose any claims detail?
No. Generated resources are added next to the original ExplanationOfBenefit resources.
How do we tell generated resources from native ones?
Every generated resource carries the claims-derived extension, and a Provenance resource links it to the claim it came from.
Does the same claim always produce the same resources?
Yes. IDs are computed from the claim, so the pipeline is idempotent across re-syncs.
Which insurers does it run on?
Payer endpoints Flexpa has identified as missing clinical resources.
Which Flexpa plans include Claims to clinical data normalization?
Claims to clinical data normalization is included in the Scale, Omni and Infrastructure plans. On Startup and Growth, it is $5,000 a year.
Spotlights
More add-ons
MCP server
Give your agent the whole health record.
C-CDA to PDF conversion
Every record, one PDF.
SSO (SAML, OIDC, SCIM sync)
Sign in to Flexpa like everything else.
C-CDA to FHIR conversion
Turn TEFCA documents into FHIR you can query.
Proprietary network connections
Reach the employer plans your users actually have.
SMART Health Links
Share records with a link or a QR code.
Every claim, a clinical story.
Connect a test patient in the demo and see claims and clinical data side by side.
Get a demo