NHCN Enterprise API

Integrate health coaching outcomes directly into your health systems, EMRs, and business intelligence platforms.

Secure, standards-based API for enterprise integration and data access.

The NHCN Enterprise API enables organizations to securely access health coaching data, integrate outcomes into clinical workflows, and leverage coaching insights for population health management. Built on REST architecture with comprehensive security controls, the API supports seamless integration with EHRs, data warehouses, analytics platforms, and custom applications.

What You Can Do With the NHCN API

Access Coaching Data

Retrieve comprehensive coaching and outcomes data:

? Patient Coaching Records: Coaching sessions, progress notes, interventions
? Health Outcomes: Weight, vital signs, lab values, health metrics
? Behavior Change: Goals, actions, adherence, lifestyle improvements
? Coach Information: Coach profiles, certifications, specializations
? Program Data: Program enrollment, completion status, effectiveness metrics

Integrate Into Workflows

Embed coaching data into your systems:

? EHR Integration: Push coaching outcomes directly into patient charts
? Care Coordination: Alert care teams to patient progress and adherence
? Population Health: Include coaching metrics in population dashboards
? Quality Reporting: Use coaching data in HEDIS, STARS, clinical quality reporting
? Custom Applications: Build coaching-aware applications on top of NHCN data

Analyze & Report

Create custom analytics and reports:

? Program ROI: Calculate return on investment of coaching programs
? Outcome Trends: Track health improvements over time
? Cohort Analysis: Compare outcomes across patient populations
? Coach Performance: Analyze coaching effectiveness and quality
? Custom Dashboards: Build BI tools with real-time coaching data

Enable Bidirectional Data Exchange

Two-way integration possibilities:

? Patient Data Sync: Sync patient demographics and clinical data from your EHR
? Referral Integration: Create coaching referrals programmatically
? Clinical Data Push: Send lab values, vitals, medications to NHCN platform
? Workflow Triggers: Automated actions based on coaching events
? Real-Time Sync: Near-real-time data synchronization with webhooks

Available Data Endpoints

Patient & Client Data

/api/patients - Patient roster, demographics, enrollment status
/api/patients/{id} - Individual patient profile and history
/api/patients/{id}/outcomes - Health outcomes and metrics
/api/patients/{id}/coaching-sessions - Session history and progress notes
/api/patients/{id}/goals - Current and historical goals
/api/patients/{id}/adherence - Medication and lifestyle adherence data

Coach & Provider Data

/api/coaches - Coach directory and availability
/api/coaches/{id} - Coach profile, certifications, specializations
/api/coaches/{id}/patients - Coach's patient roster
/api/coaches/{id}/performance - Coaching effectiveness metrics
/api/coaches/{id}/schedule - Availability and calendar
/api/coaches/{id}/credentials - Credential status and verification

Program & Outcome Data

/api/programs - Available programs and curricula
/api/programs/{id}/enrollment - Program enrollment data
/api/programs/{id}/outcomes - Program-level outcomes and metrics
/api/outcomes/bulk - Bulk outcome exports by date range
/api/outcomes/summary - Summary statistics and aggregations
/api/referrals - Referral history and status tracking

Administrative & Reporting Data

/api/organizations - Organization details and configuration
/api/organizations/{id}/usage - API usage and resource consumption
?/api/reports/quality - Quality measure data and HEDIS/STARS metrics
/api/reports/roi - ROI calculations and cost savings analysis
/api/audit-log - Audit trail of all API access
/api/webhook-events - Webhook event history and status

Common Integration Scenarios

EHR Integration

Scenario: Integrate NHCN coaching data into your EHR system for unified patient care.

What flows: Coaching outcomes, progress notes, goals, adherence data
Frequency: Real-time or daily batch syncs
Benefit: Providers see coaching progress in patient chart
Integration type: FHIR API, custom ETL, middleware (e.g., MuleSoft, Boomi)
Effort: Medium (4-12 weeks depending on EHR complexity)

Population Health Dashboards

Scenario: Build population health dashboards showing coaching metrics and outcomes.

What flows: Outcome data, enrollment metrics, quality measures, ROI
Frequency: Daily or real-time updates
Benefit: Monitor program effectiveness and impact at scale
Integration type: REST API with BI tool (Tableau, Power BI, Looker)
Effort: Low-Medium (2-6 weeks for typical implementation)

Care Coordination Platform

Scenario: Embed coaching data into your care coordination or care management platform.

What flows: Patient coaching status, adherence alerts, progress updates
Frequency: Real-time alerts via webhooks
Benefit: Care team notified of patient progress and barriers to adherence
Integration type: REST API with webhook triggers
Effort: Low-Medium (2-4 weeks)

Quality Reporting & Compliance

Scenario: Automate quality measure reporting (HEDIS, STARS, CMS) with coaching data.

What flows: Measure denominator/numerator data, quality outcomes
Frequency: Scheduled extracts aligned with reporting cycles
Benefit: Reduce manual data gathering, improve quality measure performance
Integration type: Bulk export API with ETL to reporting system
Effort: Medium (4-8 weeks for specification and validation)

Referral Management

Scenario: Automate coaching referral creation from your system into NHCN.

What flows: Patient data and referral parameters from your system to NHCN
Frequency: Real-time as referrals are created
Benefit: Seamless referral workflow without manual entry
Integration type: REST API POST to create referrals
Effort: Low (1-2 weeks)

Custom Analytics & BI

Scenario: Build custom analytics and BI using NHCN data and your internal data.

What flows: Complete patient and program data exports
Frequency: Daily or scheduled extracts
Benefit: Comprehensive analytics combining clinical and coaching data
Integration type: Bulk export API to data warehouse or analytics platform
Effort: Medium (4-12 weeks depending on complexity)

API Technology & Standards

Architecture

Style: REST API
Protocol: HTTPS/TLS 1.2+
Format: JSON
Version: v1 (v2 in development)
Rate Limiting: 1000 requests/minute
Pagination: Limit/offset, max 1000 records

Security & Auth

Authentication: OAuth 2.0
API Keys: Organization-scoped tokens
Encryption: AES-256 at rest, TLS in transit
Access Control: Role-based (RBAC)
Data Masking: PII redaction options
Audit Logging: All access logged and retrievable

Standards & Compliance

FHIR: HL7 FHIR R4 supported
HIPAA: BAA included, all controls
HITRUST: HITRUST CSF certified
SOC 2: Type II audit completed
Data Residency: US-based (EU options available)
Uptime SLA: 99.9% guaranteed

Security & Compliance Controls

Data Security

Encryption in Transit:
TLS 1.2+ for all API traffic, certificate pinning available
Encryption at Rest:
AES-256 encryption for all stored data in database
Key Management:
FIPS 140-2 compliant key storage, automated rotation
Data Masking:
Optional PII masking for development/testing environments
Secure Deletion:
30-day retention after deletion, cryptographic wiping

Access Control & Authentication

OAuth 2.0 Authentication:
Industry standard, token-based authentication
API Key Management:
Organization-scoped keys, rotation recommended quarterly
Role-Based Access Control:
Granular permissions by role (viewer, editor, admin)
Audit Logging:
All API access logged with timestamp, user, action, data accessed
IP Whitelisting:
Optional IP restrictions for additional security

Compliance & Standards

HIPAA Compliance:
Business Associate Agreement (BAA), all safeguards implemented
HITRUST CSF Certification:
Level 2 certification demonstrates healthcare security maturity
SOC 2 Type II:
Annual audit confirms security, availability, confidentiality controls
FHIR R4 Compliance:
HL7 FHIR standard for healthcare data exchange
Privacy Shield & GDPR:
EU data residency option, GDPR compliance for international orgs

Infrastructure & Operations

Cloud Hosting:
AWS/Azure on healthcare-compliant infrastructure
Disaster Recovery:
Geographically redundant backups, RTO 1 hour, RPO 15 minutes
DDoS Protection:
Rate limiting, WAF, automatic attack mitigation
Uptime SLA:
99.9% availability guarantee, credits for downtime
Monitoring & Alerting:
24/7 monitoring, incident response < 15 min for severity 1 issues

Use Cases by Organization Type

Health Systems & IDNs

Key Use Cases:

• EHR integration for unified patient view
• Care coordination across specialties
• Population health dashboards
• Quality measure reporting (HEDIS, STARS)
• Readmission risk management
• ACO shared savings optimization

Health Plans & Insurers

Key Use Cases:

• Member engagement analytics
• STAR measure improvement
• Total cost of care reduction
• Risk and benefit management
• Provider performance reporting
• Automated quality reporting

Employers

Key Use Cases:

• Wellness program analytics
• Health cost reduction tracking
• Employee engagement metrics
• Absenteeism and presenteeism
• ROI calculation for wellness
• Vendor performance comparison

Consulting & Tech Partners

Key Use Cases:

• Custom health apps/platforms
• Business intelligence tools
• EHR/HIE connectors
• Care coordination platforms
• Population health solutions
• Research and analytics

Getting Started With the NHCN API

5 Steps to API Integration

Step 1: Evaluation & Planning

? Review API documentation and capabilities
? Identify your integration use case and requirements
? Schedule consultation with NHCN technical team
? Review security and compliance requirements
? Estimate timeline and resource needs

Step 2: Access & Setup

? Request API access through portal
? Complete security questionnaire
? Sign Data Use Agreement and BAA (if applicable)
? Receive API keys and sandbox environment
? Access documentation and SDK libraries

Step 3: Development & Testing

? Develop integration in sandbox environment
? Test with sample data and flows
? Implement security controls and error handling
? Conduct performance and load testing
? Complete security review with NHCN

Step 4: UAT & Validation

? Migrate to UAT environment with real data
? Conduct end-to-end testing with stakeholders
? Validate data accuracy and completeness
? Obtain sign-off from NHCN and your organization
? Document procedures and runbooks

Step 5: Go-Live & Support

? Plan go-live timing and communication
? Execute cutover to production environment
? Monitor integration closely during ramp-up
? Have NHCN support team on standby
? Establish ongoing support and governance

Timeline & Resources

Timeline: 4-16 weeks depending on complexity
Your Resources: 1-3 developers, technical lead
NHCN Support: Dedicated integration engineer
Cost: API subscription + integration services (if needed)

API Pricing & Support Options

Pricing Model

Flexible options to match your needs:

Per-Call Pricing:
Pay per API call, volume discounts available
Monthly Tiers:
$500-$5,000/month based on data volume and features
Enterprise Licensing:
Custom pricing for large-scale deployments
Free Developer Tier:
Sandbox access with 10K calls/month for development

Support Levels

Dedicated support for your success:

Developer Support:
Email support, documentation, community forums
Standard Support:
24/7 phone/email, 4-hour response for critical issues
Premium Support:
Dedicated engineer, 1-hour response, proactive monitoring
Professional Services:
Integration help, custom development, training

Resources

Everything you need to succeed:

API Documentation:
Complete API reference with code examples
SDK Libraries:
JavaScript, Python, Java, C# libraries available
Integration Guides:
Guides for popular platforms (Salesforce, Epic, Cerner)
Postman Collection:
Ready-to-run API calls for testing and learning

Frequently Asked Questions

Is the API HIPAA compliant?

Yes. The NHCN API is fully HIPAA compliant. We provide a Business Associate Agreement (BAA) with our standard terms. All data is encrypted in transit (TLS 1.2+) and at rest (AES-256). We maintain detailed audit logs of all API access. All customers are covered by our HITRUST CSF certification and SOC 2 Type II audit.

What data formats are supported?

The API primarily uses JSON format. We support HL7 FHIR R4 standard for healthcare data exchange. CSV exports are available for bulk data extracts. XML support is available for legacy integrations.

How often is data updated?

Data is updated in real-time as coaching sessions and outcomes are documented. You can pull data via API at any time. We recommend daily batch extracts for most use cases, but real-time polling or webhook notifications are available for critical data.

Can we integrate with our specific EHR?

We support integration with most major EHRs: Epic, Cerner, Athena, NextGen, etc. We have existing integrations with several platforms, and we can work with you to build custom integrations using our REST API. An integration consultant can evaluate your specific EHR and provide an estimate.

What's included in API access?

API access includes: full documentation, code examples, SDK libraries, sandbox environment for testing, production environment access, API keys for authentication, audit logging, and technical support. Additional integration services and dedicated engineers are available for an additional fee.

What's your API uptime guarantee?

We guarantee 99.9% uptime with a Service Level Agreement (SLA). The API is geographically redundant with automatic failover. We monitor 24/7 and have an incident response team ready to address any issues. Service credits are available if we miss our uptime target.

Ready to Integrate?

Let's discuss how the NHCN API can unlock new insights and improve your health outcomes.

Request API Access View Full Documentation