A focused EHR integration typically takes 4 to 8 weeks, while larger, multi-system or regulation-driven programmes run 3 to 6 months or more. There is no single answer, because connecting one app to one FHIR endpoint is very different from building the four APIs a payer needs for CMS-0057-F. The honest way to estimate is by integration type and scope, and to remember that vendor access and your own internal approvals often affect the timeline as much as the engineering.
The good news is that the ground has shifted in favour of speed. With around 93% of certified health-IT customers now exposing a FHIR API, modern integrations are faster than the old HL7 v2 interface work of a decade ago. But "faster" still means weeks to months, not days, and the parts people underestimate are usually access, testing and approvals rather than writing the code. This guide breaks down the phases, the timelines by type, and how to move quickly without cutting corners.
How long does an EHR integration take?
A single, well-scoped EHR integration usually takes 4 to 8 weeks from kickoff to production, assuming timely access to the systems and test data. Multi-system integrations, complex data mapping, or regulatory programmes such as CMS-0057-F extend that to 3 to 6 months or beyond.
The variation is real and comes mostly from scope and access, not from mystery. Reading data from one FHIR endpoint is quick; two-way integration across several systems with strict data mapping and vendor approvals is not. The most reliable estimate comes from defining exactly what you are connecting, to what, and for what purpose.
What are the phases of an EHR integration?
Every EHR integration moves through the same core phases, and each takes time regardless of how good the engineering is. Understanding them explains where the weeks go.
- Discovery and scoping. Define the data, systems, standards and use case.
- Access and credentials. Get sandbox access, API keys and vendor approvals.
- Data mapping. Map source data to the target model, aligned to FHIR or USCDI.
- Build. Develop the integration, transformation and API layer.
- Testing and conformance. Validate against implementation guides and real data.
- Deployment and go-live. Move to production, with vendor and client sign-off.
Two of these, access and testing, are the ones teams most often underestimate, because they depend on other parties rather than on your developers.
What affects the timeline?
The timeline is driven by scope, the systems involved, data quality, and how quickly access and approvals come through. These are the factors that stretch or shrink the schedule.
- Number of systems. One endpoint is fast; several is not.
- Direction. Read-only is quicker than two-way read and write.
- Standard. Modern FHIR is generally faster than legacy HL7 v2 interface work.
- Data quality and mapping. Messy or inconsistent source data adds time.
- Vendor access. Sandbox access and production approvals can gate the schedule.
- Internal approvals. Security, compliance and clinical sign-offs take real time.
- Regulatory scope. CMS-0057-F conformance and testing add structured effort.
The pattern worth remembering: much of the timeline is outside pure engineering. Planning for access and approvals early is the single biggest way to protect the schedule.
Timelines by integration type
Here is an indicative view by common scenario. Use it to plan, then scope precisely.
| Integration type | Typical timeline | Notes |
|---|---|---|
| Read-only from one FHIR endpoint | 4 to 6 weeks | Fastest common case |
| Two-way single-system integration | 6 to 10 weeks | Read and write, more testing |
| SMART on FHIR app in the EHR | 6 to 12 weeks | Includes launch and auth |
| Multi-system or data-platform integration | 3 to 5 months | Mapping and orchestration |
| CMS-0057-F API programme (payers) | 4 to 6+ months | Multiple APIs, conformance, testing |
These are starting points, not quotes. Access speed and data quality can move any of them by weeks.
The engineering is often the quick part. Access, data mapping, testing and approvals are what really shape an EHR integration timeline, so plan those first.
