API Reference/Integrations

Integrations

Integrations connect HealthCloud to EHR systems (Epic, Cerner, Athena), labs, payers, and devices via FHIR or proprietary APIs.

GET/integrationsGET/integrations/{id}POST/integrations/{id}/syncPOST/integrations/{id}/connectDELETE/integrations/{id}/connect

The Integration Object

FieldTypeDescription
idstringUnique integration ID (e.g. int_epic_001)
typestringIntegration category: ehr | lab | payer | device | identity
namestringDisplay name of the connected system (e.g. Epic FHIR R4)
statusstringConnection health: connected | disconnected | error | syncing
fhirBasenullablestringFHIR R4 base URL for EHR integrations
lastSyncAtnullabledatetimeISO 8601 UTC timestamp of the last successful data sync
recordsSyncedintegerTotal number of FHIR records synced across all time

Endpoints

Returns all configured integrations for a project.

Parameters

ParameterInTypeRequiredDescription
projectIde.g. proj_rpm_001querystringrequiredProject ID
typee.g. ehrquerystringoptionalIntegration type (ehr|lab|payer|device)

Request

curl "https://api.healthcloud.ai/v1/integrations?projectId=proj_rpm_001" \
  -H "Authorization: Bearer hc_test_sk_demo_live_xxxxxx"

Response

Response200
{
  "data": [
    {
      "id": "int_epic_001",
      "type": "ehr",
      "name": "Epic FHIR R4",
      "status": "connected",
      "lastSyncAt": "2026-03-18T11:55:00Z",
      "recordsSynced": 14230
    }
  ]
}

Previous

Datasets

Next

Patients

Related Resources

OrganizationsUsersProjectsAssets