API v3.2 Now Available

Technical infrastructure for health data.

Connect fragmented healthcare systems with a unified API. Our developer tools provide secure, compliant, and lightning-fast interoperability right out of the box.

Get API KeysRead the Docs
bash
$ npm install @ppussh/health-sdk

$ ppussh auth login
Authenticating via OAuth2... Success.

$ ppussh query patient --id="p_7x9Q2m"
{
  "status": "success",
  "data": {
    "id": "p_7x9Q2m",
    "network": "unified_health_v2",
    "connections": 14
  }
}

Build in 5 minutes

Initialize the SDK and make your first secure data exchange.

Node.jsPythonGo
import { PPUSSHClient } from '@ppussh/health';

// 1. Initialize client with environment secret
const client = new PPUSSHClient({
  apiKey: process.env.PPUSSH_API_KEY,
  environment: 'sandbox'
});

// 2. Query normalized clinical data
async function fetchRecords() {
  const records = await client.exchange.read({
    patientId: 'pat_84920',
    resourceType: 'Observation'
  });
  
  return records.data;
}
1

Install & Authenticate

Grab your keys from the dashboard and initialize the SDK. Our libraries handle token rotation and mTLS automatically.

2

Query Standardized Data

Request data using standard FHIR resources or our simplified graph schema. We map hundreds of proprietary formats instantly.

API Documentation Preview

Explore core endpoints and capabilities.

v2.1

Identity

Resolve patient identities across disjointed master patient indices (MPIs) using probabilistic matching.

POST /identity/match
GET /identity/{id}
v3.0

Discovery

Locate actionable health records across connected facilities nationwide before querying data.

POST /discover/network
GET /discover/status
v3.2

Exchange

Push and pull clinical documents (C-CDA, FHIR) with robust schema validation and normalization.

GET /exchange/document
POST /exchange/push
Testing Environment

Synthetic Sandbox

Test your integration against 100,000+ synthetic patient profiles complete with longitudinal clinical histories, without handling real PHI.

Access Sandbox
Sandbox Status Operational
Active Mocks142,890
Latency42ms

Official SDKs

Type-safe libraries for rapid development.

Node.js / TypeScript
Python
Go

Adapter Implementation

Building a custom EHR adapter? Follow our standardized interface guidelines to ensure seamless data ingestion and outbound routing.

View Adapter Specification
AdapterInterface.ts
EHRMapper.ts
/**
 * Standard interface for all custom EHR adapters
 */
export interface IEHRAdapter {
  // Authentication & Connectivity
  connect(): Promise<ConnectionStatus>;
  
  // Data Retrieval
  getPatient(id: string): Promise<NormalizedPatient>;
  getClinicalNotes(patientId: string, dateRange: DateRange): Promise<Document[]>;
  
  // Write capabilities (if supported by underlying system)
  writeObservation(data: ObservationPayload): Promise<boolean>;
}