# US Hospital & Clinic EHR Tech Enricher (Epic & Cerner) (`zinky_atelier/us-hospital-ehr-tech-enricher`) Actor

Enrich US hospitals, health systems, and clinics with verified Epic Systems and Oracle Health (Cerner Millennium & Soarian) EHR deployments, live FHIR R4 endpoints, NPIs, EINs, and go-live deltas via mandatory 21st Century Cures Act / HTI-1 registries.

- **URL**: https://apify.com/zinky_atelier/us-hospital-ehr-tech-enricher.md
- **Developed by:** [Travis Burrows](https://apify.com/zinky_atelier) (community)
- **Categories:** Lead generation, Business, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $14.00 / 1,000 hospital ehr record enricheds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## US Hospital & Clinic EHR Tech Stack Enricher (Epic & Oracle Cerner)

Enrich US hospitals, health systems, and outpatient clinics with **verified live EHR vendor deployments (`Epic Systems` vs. `Oracle Health / Cerner`), active FHIR R4 endpoints, 10-digit NPIs, Federal EINs, custom hospital domains, physical addresses, and newly live go-live deltas**—powered directly by mandatory **21st Century Cures Act / ONC HTI-1 (45 CFR § 170.404)** machine-readable FHIR R4 Organization & Endpoint bundles.

Zero headless browsers. Zero residential proxies. Streaming O(1)-per-entry JSON parser runs comfortably inside **512 MB RAM** (`< 120 MB` typical RSS) and integrates natively with **Clay, Make, n8n, Zapier, scheduled Apify Webhooks, and `mcp.apify.com` AI agents**.

***

### Why Healthcare GTM, RCM & Clinical-AI Teams Use This Actor

Legacy healthcare intelligence databases charge **$25,000–$60,000/year** just to tell outbound sales and RevOps teams whether a hospital runs **Epic Hyperdrive/MyChart**, **Oracle Health Millennium**, or **Oracle Health Soarian Clinicals**. Under federal Cures Act / HTI-1 interoperability rules, Epic and Oracle publish daily/weekly production FHIR R4 service base URL bundles covering **1,800+ health systems and 98,000+ US clinical locations**.

| Target B2B Workflow | How Teams Automate It |
| :--- | :--- |
| **Clay / CRM Batch Account Enrichment** | Pass 500–5,000 hospital names (`"Peconic Bay Medical Center \| Riverhead, NY"`), custom domains (`"wacofhc.org"`, `"kp.org"`), or 10-digit NPIs (`"1912011511"`) in `targets` to append exact `ehrVendor`, `ehrPlatform`, `patientFhirEndpointUrl`, `primaryNpi`, and `matchConfidence`. |
| **New EHR Go-Live & Migration Alerts** | Schedule weekly runs with `mode: "catalog"` and `onlyNew: true` (`SEEN_ENDPOINTS` stateful Key-Value Store) to push `NEW_ENDPOINT` and `UPDATED_ENDPOINT` hospital go-lives straight into Slack, HubSpot, or Salesforce. |
| **Territory Segmentation by US State** | Pull verified Epic vs. Oracle Cerner accounts in target states (`states: ["TX", "FL", "NY"]`) for healthcare SaaS, RCM/medical billing, cybersecurity, and clinical-AI SDR territories. |
| **FHIR Interoperability & AI Agent Discovery** | Query via `mcp.apify.com` to resolve live Patient-Access and Provider R4 FHIR base URLs (`patientFhirEndpointUrl`, `providerFhirEndpointUrl`) for SMART-on-FHIR apps. |

***

### Transparent Pay-Per-Event (PPE) Pricing

| PPE Event Name | When It Is Charged | Notes |
| :--- | :--- | :--- |
| `actor-start` | Once per Actor run start (`count: 1`) | Covers initial Cures Act FHIR R4 bundle indexing. |
| `hospital-enriched` | `1` per matched/emitted hospital or clinic record | **Fair-billing guarantee:** Unmatched rows in `enrich` mode (`matched: false`) and deduplicated rows skipped via `onlyNew: true` are **never** charged! |

***

### Quick-Start Input Examples

#### 1. Clay / RevOps Batch Hospital, Domain & NPI Enrichment (`mode: "enrich"`)

```json
{
  "mode": "enrich",
  "targets": [
    "EverWell Precision Health | Naples, FL",
    "Peconic Bay Medical Center | Riverhead, NY",
    "wacofhc.org",
    "1912011511"
  ],
  "vendors": ["epic", "oracle_health"],
  "includeUnmatchedTargets": true
}
```

#### 2. Scheduled State Go-Live Delta Feed (`mode: "catalog"`, `onlyNew: true`)

```json
{
  "mode": "catalog",
  "vendors": ["epic", "oracle_health"],
  "states": ["FL", "TX"],
  "goLiveWithinDays": 180,
  "onlyNew": true,
  "maxItems": 100
}
```

***

### Sample Output Record

```json
{
  "recordId": "epic-brand:1233-9",
  "organizationName": "EverWell Precision Health",
  "parentHealthSystemName": "NCH Healthcare System, Inc.",
  "recordGranularity": "health_system_or_org",
  "ehrVendor": "Epic Systems",
  "ehrPlatform": "Epic Hyperdrive / MyChart",
  "fhirVersion": "4.0.1",
  "fhirEndpointStatus": "active",
  "patientFhirEndpointUrl": "https://epicproxy.et1233.epichosted.com/FHIRProxy/api/FHIR/R4",
  "providerFhirEndpointUrl": "https://epicproxy.et1233.epichosted.com/FHIRProxy/api/FHIR/R4",
  "fhirHostDomain": "epicproxy.et1233.epichosted.com",
  "inferredOrganizationDomain": null,
  "endpointGoLiveDate": "2025-12-31",
  "lastUpdatedDate": "2026-11-12",
  "primaryNpi": null,
  "npiNumbers": [],
  "federalTaxIdEin": null,
  "hl7OrgOid": "1233-9",
  "streetAddress": "1879 Veterans Park Dr., Suite 1202",
  "city": "Naples",
  "state": "FL",
  "postalCode": "34109",
  "country": "US",
  "clinicLocationCount": 1,
  "sampleStatesCovered": ["FL"],
  "sourceFeeds": ["epic_brands"],
  "deltaStatus": "NEW_ENDPOINT",
  "queryTarget": "EverWell Precision Health | Naples, FL",
  "matched": true,
  "matchConfidence": 0.99,
  "matchMethod": "exact_name",
  "scrapedAt": "2026-11-14T04:25:00.000Z"
}
```

***

### Authoritative Public Data Sources

1. **Epic Systems Cures Act / HTI-1 Endpoints:** `https://open.epic.com/Endpoints/R4` & `https://open.epic.com/Endpoints/Brands`
2. **Oracle Health (Cerner) Ignite FHIR R4 Endpoints:** `millennium_patient_r4_endpoints.json`, `millennium_provider_r4_endpoints.json`, and `soarian_patient_r4_endpoints.json`

***

### How Much Does It Cost? (Tiered Pay-Per-Event Pricing)

Unmatched hospital lookups cost `$0`. Paid Apify tiers automatically unlock lower per-hospital enrichment rates:

| Event | One-Time? | Free Plan | Bronze | Silver | Gold / Enterprise |
| :--- | :---: | :---: | :---: | :---: | :---: |
| `actor-start` | Yes | `$0.02` | `$0.02` | `$0.02` | `$0.02` |
| `hospital-enriched` *(Primary)* | No | `$0.02` | `$0.018` | `$0.016` | `$0.014` |

#### Clay, Make, n8n & AI Agent (`mcp.apify.com`) Chaining

- **Clay.com Batch Account Scoring:** Enrich target hospital names, domains, or 10-digit NPIs with verified Epic Systems vs. Oracle Health (Cerner) FHIR R4 deployment status and EINs.
- **Make / n8n Weekly Go-Live Monitor:** Schedule `onlyNew: true` in `discover` mode to route newly live hospital EHR endpoints directly to Slack or Salesforce.
- **AI Agents & MCP (`mcp.apify.com`):** Query authoritative ONC HTI-1 / Cures Act hospital EHR tech stacks on demand from MCP-enabled clinical and GTM agents.

# Actor input Schema

## `mode` (type: `string`):

Choose 'catalog' to browse/monitor verified Epic & Oracle Health hospitals by state or recency, or 'enrich' to match a batch list of hospital names, domains, or NPIs (automatically switches to 'enrich' if `targets` is populated).

## `targets` (type: `array`):

List of healthcare organizations to match in 'enrich' mode. Accepts hospital/clinic names ('Peconic Bay Medical Center'), name + location ('EverWell Precision Health | Naples, FL'), custom domains ('wacofhc.org', 'kp.org'), or 10-digit NPIs ('1912011511').

## `vendors` (type: `array`):

Select which mandatory Cures Act / HTI-1 vendor registries to include: 'epic' (Epic R4 + Epic User-Access Brands) and/or 'oracle_health' (Oracle Health Millennium Patient/Provider + Soarian Clinicals).

## `states` (type: `array`):

Restrict catalog discovery to one or more 2-letter US state/territory codes (e.g. \['TX', 'FL', 'CA', 'NY']). Leave empty for nationwide.

## `city` (type: `string`):

Filter catalog results to a specific city name (case-insensitive, e.g. 'Naples', 'Riverhead').

## `searchKeyword` (type: `string`):

Case-insensitive keyword filter matched against organization name, parent health system, or domain.

## `goLiveWithinDays` (type: `integer`):

When > 0 (e.g. 90 or 180), keeps only records whose `endpointGoLiveDate` or `lastUpdatedDate` falls within the last N days. Leave 0 to include all active deployments.

## `includeClinicLocations` (type: `boolean`):

By default (false), Epic's 98,000+ outpatient clinic locations are rolled up onto their parent Health System / Brand (`clinicLocationCount`). Enable to emit individual clinic location rows.

## `includeUnmatchedTargets` (type: `boolean`):

In 'enrich' mode, emit unmatched targets with `matched: false` and `ehrVendor: null` for 1-to-1 Clay/CSV alignment. Unmatched rows are NEVER billed a PPE `hospital-enriched` event.

## `excludeSandboxes` (type: `boolean`):

Filter out non-production test/sandbox organizations (e.g. 'Public Sandbox', 'Test Harness').

## `onlyNew` (type: `boolean`):

Persists seen records in the `SEEN_ENDPOINTS` Key-Value Store across scheduled runs and emits only `NEW_ENDPOINT` or `UPDATED_ENDPOINT` deployments.

## `maxItems` (type: `integer`):

Maximum number of hospital/clinic records emitted in this run.

## `maxEpicBrandsEntries` (type: `integer`):

Bounds streaming over Epic's 97 MB (100,165-entry) Brands bundle for fast sub-10s runs while preserving low RAM (< 150 MB). Set to 0 to stream the entire 100k+ entry bundle.

## Actor input object example

```json
{
  "mode": "catalog",
  "targets": [
    "Waco Family Medicine | TX",
    "Peconic Bay Medical Center | Riverhead, NY",
    "wacofhc.org",
    "1912011511"
  ],
  "vendors": [
    "epic",
    "oracle_health"
  ],
  "states": [
    "FL",
    "TX",
    "NY"
  ],
  "goLiveWithinDays": 0,
  "includeClinicLocations": false,
  "includeUnmatchedTargets": true,
  "excludeSandboxes": true,
  "onlyNew": false,
  "maxItems": 50,
  "maxEpicBrandsEntries": 15000
}
```

# Actor output Schema

## `hospitals` (type: `string`):

Dataset of verified Epic and Oracle Health (Cerner) organizations, FHIR R4 endpoints, NPIs, EINs, and match scores.

## `runSummary` (type: `string`):

JSON summary of sources queried, total catalog records indexed, records emitted, delta deduplication counts, and PPE events charged.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "targets": [
        "Waco Family Medicine | TX",
        "Peconic Bay Medical Center | Riverhead, NY",
        "wacofhc.org",
        "1912011511"
    ],
    "vendors": [
        "epic",
        "oracle_health"
    ],
    "states": [
        "FL",
        "TX",
        "NY"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zinky_atelier/us-hospital-ehr-tech-enricher").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "targets": [
        "Waco Family Medicine | TX",
        "Peconic Bay Medical Center | Riverhead, NY",
        "wacofhc.org",
        "1912011511",
    ],
    "vendors": [
        "epic",
        "oracle_health",
    ],
    "states": [
        "FL",
        "TX",
        "NY",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("zinky_atelier/us-hospital-ehr-tech-enricher").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "targets": [
    "Waco Family Medicine | TX",
    "Peconic Bay Medical Center | Riverhead, NY",
    "wacofhc.org",
    "1912011511"
  ],
  "vendors": [
    "epic",
    "oracle_health"
  ],
  "states": [
    "FL",
    "TX",
    "NY"
  ]
}' |
apify call zinky_atelier/us-hospital-ehr-tech-enricher --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zinky_atelier/us-hospital-ehr-tech-enricher"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/WExzdCQueS88G8F1J/builds/M5yuJb9D9pAfpX8IW/openapi.json
