1upHealth API Collection - All endpoints

Name: 1upHealth API Collection - All endpoints API
Brand: 1upHealth API Collection - All endpoints
Availability: InStock

★ Only Publicly Available SpecHealthcareEhr Emroauth221 EndpointsREST

For Agents

Aggregate patient health data from multiple EHRs and health systems via FHIR, manage user connections, perform bulk exports, and search healthcare providers through a unified API.

Quickstart

Get started with 1upHealth API Collection - All endpoints in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"aggregate patient health data from multiple EHRs"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with 1upHealth API Collection - All endpoints API.

Connect patients to hundreds of health systems and retrieve their consolidated health records via FHIR

Exchange OAuth 2.0 authorization codes for access tokens to access patient-consented health data

Query FHIR R4 resources including Patient, Observation, and MedicationRequest across connected systems

Export all patient data in bulk via the $everything operation for comprehensive record retrieval

GET STARTED

Start building with 1upHealth API Collection - All endpoints API

Explore with Jentic

View OpenAPI Spec

Jentic publishes the only available OpenAPI specification for 1upHealth API Collection - All endpoints, keeping it validated and agent-ready.

Aggregate patient health data from multiple EHRs, health systems, and payers through a unified FHIR-based interface with 21 endpoints. The API supports user management, OAuth 2.0 token exchange, FHIR R4 and DSTU2 resource access, bulk data export, provider search, health system connectivity, and granular permission management. Connect to hundreds of health systems and retrieve Patient, Observation, MedicationRequest, DocumentReference, and other FHIR resources through a single integration point.

Use Cases

Patterns agents use 1upHealth API Collection - All endpoints API for, with concrete tasks.

★ AI Agent Health Data Aggregation

AI agents aggregate patient health data from multiple EHRs through Jentic by connecting to 1upHealth's unified FHIR interface. An agent creates a user, generates an auth code, exchanges it for an access token, and then retrieves FHIR resources spanning all connected health systems. Jentic manages the OAuth flow and token lifecycle, enabling agents to focus on clinical data processing rather than multi-system authentication.

Create a new user, generate an authorization code, exchange it for an access token, then retrieve all Patient resources from connected health systems and list their active conditions

Multi-System Patient Record Retrieval

Pull a patient's complete health record aggregated from all connected health systems through a single API call. The $everything operation on Patient returns all clinical data including conditions, medications, allergies, procedures, and lab results from every connected source. This eliminates the need to query each health system individually and produces a longitudinal patient view.

Execute GET /{FHIRVersion}/Patient/{patientID}/$everything to retrieve all health data for patient ID 12345, then extract medication lists and flag any potential drug interactions

Provider and Health System Discovery

Search for healthcare providers by name, specialty, or location and discover which health systems are available for patient connections. The provider search endpoint returns matching practitioners with their affiliated systems, enabling applications to guide patients through the connection process. Connected system metadata includes supported FHIR versions and data categories available.

Search for primary care providers in the connected health systems, then list all clinical systems available for patient connection with their supported FHIR versions

Bulk Data Export for Analytics

Export patient health data in bulk for population health analytics, research, or compliance reporting. The GET /$export endpoint initiates a FHIR Bulk Data Export that produces NDJSON files containing all resources for the authorized patient population. Supports filtering by resource type and date range for targeted exports.

Initiate a bulk data export via GET /$export for all Patient and Observation resources, then poll the export status until complete and retrieve the NDJSON output files

Key Endpoints

21 endpoints — aggregate patient health data from multiple ehrs, health systems, and payers through a unified fhir-based interface with 21 endpoints.

METHOD

PATH

DESCRIPTION

POST

/user-management/v1/user

Create a new user

POST

/user-management/v1/user/auth-code

Generate authorization code for user

POST

/oauth2/token

Exchange auth code for access token

GET

/r4/Patient

Get FHIR R4 Patient resources

GET

/{FHIRVersion}/Patient/{patientID}/$everything

Get all patient data

GET

/$export

Bulk data export

POST

/search

Provider search

GET

/connect/system/clinical

Get connected health systems

POST

/user-management/v1/user

Create a new user

POST

/user-management/v1/user/auth-code

Generate authorization code for user

POST

/oauth2/token

Exchange auth code for access token

GET

/r4/Patient

Get FHIR R4 Patient resources

GET

/{FHIRVersion}/Patient/{patientID}/$everything

Get all patient data

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

1upHealth OAuth 2.0 credentials and user-specific access tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive patient-scoped bearer tokens with automatic refresh — raw client secrets and user auth codes never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'aggregate patient health records from multiple systems') and Jentic returns matching 1upHealth operations with their schemas including the required OAuth flow sequence, so the agent can connect patients and retrieve data without manual endpoint chaining.

Time to first call

Direct 1upHealth integration: 3-5 days for OAuth setup, user management flow, and FHIR resource mapping. Through Jentic: under 1 hour — search, load schema, execute with built-in token lifecycle management.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Epic on FHIR API

Direct FHIR access to Epic health systems for single-system patient data retrieval

Choose Epic on FHIR when you need direct access to a specific Epic-connected system rather than aggregating data from multiple systems through 1upHealth

Complementary

Athena Health

Direct EHR API for athenahealth practices with appointment and chart management

Choose athenahealth when you need to schedule appointments or manage clinical charts within a specific athenahealth practice rather than aggregating read-only data

Complementary

ClinicalTrials.gov API

Clinical trial registry for matching patient data against trial eligibility criteria

Choose ClinicalTrials.gov when matching aggregated patient health data from 1upHealth against clinical trial eligibility criteria

FAQs

Specific to using 1upHealth API Collection - All endpoints API through Jentic.

What authentication does the 1upHealth API use?

The 1upHealth API uses OAuth 2.0. You first create a user via POST /user-management/v1/user, generate an authorization code via POST /user-management/v1/user/auth-code, then exchange it for an access token via POST /oauth2/token. Through Jentic, this token lifecycle is managed in the MAXsystem vault and agents receive ready-to-use bearer tokens.

Can I retrieve data from multiple health systems in a single call?

Yes. The GET /{FHIRVersion}/Patient/{patientID}/$everything endpoint returns all health data aggregated from every health system the patient has connected. This includes conditions, medications, lab results, procedures, and documents from all sources in a single FHIR Bundle response.

What are the rate limits for the 1upHealth API?

1upHealth applies per-application rate limits that vary by plan tier. Standard developer accounts typically support up to 60 requests per minute. Bulk export operations run asynchronously and do not count against per-request limits. Contact 1upHealth for production rate limit details.

How do I aggregate patient records through Jentic?

Search Jentic for 'aggregate patient health data from multiple EHRs' to discover the 1upHealth endpoints. The agent first calls POST /user-management/v1/user/auth-code to get an auth code, exchanges it via POST /oauth2/token, then retrieves data via GET /r4/Patient or the $everything operation. Install via pip install jentic and use the search-load-execute flow.

Which health systems can patients connect to?

The GET /connect/system/clinical endpoint returns all available health systems for patient connections. 1upHealth supports connections to hundreds of health systems including major hospital networks, health plans, and EHR vendors. Each system entry includes its name, supported FHIR version, and available data categories.

Does the 1upHealth API support FHIR R4?

Yes. The API supports both FHIR R4 and DSTU2 resource access. R4 endpoints are available under the /r4/ path prefix, while DSTU2 resources use /dstu2/. Patient, Observation, MedicationRequest, DocumentReference, and other standard FHIR resources are accessible in both versions.