UnitedHealth Group website screenshot

UnitedHealth Group

UnitedHealth Group is a diversified health care company with two distinct platforms, UnitedHealthcare for health benefits and Optum for health services, serving more than 100 million people worldwide. The company offers FHIR R4-compliant Interoperability APIs through the Optum platform, providing patient access to health records, claims history, provider directory, and drug formulary data in compliance with CMS Interoperability and Patient Access final rule (CMS-9115-F) and HL7 FHIR standards.

1 APIs 0 Features
HealthcareHealth InsuranceFHIRClaimsInteroperabilityFortune 100

APIs

UnitedHealth Group Optum API

The UnitedHealth Group interoperability APIs provide FHIR R4-compliant access to healthcare data including patient records, claims history, provider directories, and formulary i...

Collections

GraphQL

UnitedHealth Group GraphQL Schema

UnitedHealth Group operates two primary platforms: UnitedHealthcare for health benefits and Optum for health services. This conceptual GraphQL schema represents the core data mo...

GRAPHQL

Pricing Plans

Rate Limits

Unitedhealth Rate Limits

2 limits

RATE LIMITS

FinOps

Semantic Vocabularies

Unitedhealth Optum Api Context

21 classes · 1 properties

JSON-LD

API Governance Rules

UnitedHealth Group API Rules

26 rules · 13 errors 11 warnings 2 info

SPECTRAL

JSON Structure

Optum Fhir Bundle Structure

0 properties

JSON STRUCTURE

Optum Fhir Coverage Structure

0 properties

JSON STRUCTURE

Optum Fhir Explanation Of Benefit Structure

0 properties

JSON STRUCTURE

Optum Fhir Medication Knowledge Structure

0 properties

JSON STRUCTURE

Optum Fhir Patient Structure

0 properties

JSON STRUCTURE

Optum Fhir Practitioner Structure

0 properties

JSON STRUCTURE

Example Payloads

Optum Fhir Bundle Example

7 fields

EXAMPLE

Optum Fhir Coverage Example

10 fields

EXAMPLE

Optum Fhir Patient Example

10 fields

EXAMPLE

Resources

🔗
LinkedIn
LinkedIn

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: UnitedHealth Group Optum API
  version: R4
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Patient Access
    type: folder
  items:
  - info:
      name: UnitedHealth Group Get Patient Demographics
      type: http
    http:
      method: GET
      url: https://api.uhc.com/fhir/R4/Patient/:id
      params:
      - name: id
        value: ''
        type: path
        description: FHIR Patient resource logical ID (maps to member ID)
    docs: Retrieve FHIR R4 Patient resource for a UnitedHealthcare member including demographic information, member identifiers,
      contact details, and language preferences as required by the CMS Patient Access rule.
  - info:
      name: UnitedHealth Group List Claims as Explanation of Benefit
      type: http
    http:
      method: GET
      url: https://api.uhc.com/fhir/R4/ExplanationOfBenefit
      params:
      - name: patient
        value: ''
        type: query
        description: Patient resource ID to retrieve ExplanationOfBenefits for
      - name: type
        value: ''
        type: query
        description: Claim type filter (professional, institutional, pharmacy, oral)
      - name: _lastUpdated
        value: ''
        type: query
        description: Filter by last updated date/time in FHIR date format
      - name: service-date
        value: ''
        type: query
        description: Filter by service date (FHIR date format)
      - name: _count
        value: ''
        type: query
        description: Maximum number of results per page
      - name: _offset
        value: ''
        type: query
        description: Pagination offset
    docs: Retrieve FHIR R4 ExplanationOfBenefit (EOB) resources for a member providing comprehensive claims data including
      services rendered, diagnosis codes, procedure codes, amounts billed and paid, and adjudication details. Supports CMS
      Patient Access rule compliance for claims data access.
  - info:
      name: UnitedHealth Group List Member Coverage
      type: http
    http:
      method: GET
      url: https://api.uhc.com/fhir/R4/Coverage
      params:
      - name: patient
        value: ''
        type: query
        description: Patient resource ID
      - name: status
        value: ''
        type: query
        description: Coverage status filter
    docs: Retrieve FHIR R4 Coverage resources for a member including current and historical insurance coverage details, plan
      names, benefit periods, group and member identifiers, and payer information across UnitedHealthcare commercial, Medicare,
      and Medicaid lines of business.
- info:
    name: Clinical Data
    type: folder
  items:
  - info:
      name: UnitedHealth Group List Member Conditions
      type: http
    http:
      method: GET
      url: https://api.uhc.com/fhir/R4/Condition
      params:
      - name: patient
        value: ''
        type: query
        description: Patient resource ID
      - name: clinical-status
        value: ''
        type: query
        description: Condition clinical status filter
      - name: _count
        value: ''
        type: query
        description: Maximum number of results
    docs: Retrieve FHIR R4 Condition resources for a member representing active and historical health conditions, diagnoses,
      and clinical problems as reflected in claims data and clinical records available through the Patient Access API.
- info:
    name: Provider Directory
    type: folder
  items:
  - info:
      name: UnitedHealth Group List Network Practitioners
      type: http
    http:
      method: GET
      url: https://api.uhc.com/fhir/R4/Practitioner
      params:
      - name: name
        value: ''
        type: query
        description: Provider name search
      - name: identifier
        value: ''
        type: query
        description: NPI or other identifier
      - name: specialty
        value: ''
        type: query
        description: Provider specialty taxonomy code
      - name: address-state
        value: ''
        type: query
        description: State code for geographic filter
      - name: _count
        value: ''
        type: query
        description: Maximum number of results
    docs: Search the UnitedHealthcare FHIR R4 Provider Directory for individual healthcare practitioners by name, NPI, specialty,
      or geographic location. Implements the Da Vinci PDex Plan Net Implementation Guide for provider directory services.
  - info:
      name: UnitedHealth Group List Network Organizations
      type: http
    http:
      method: GET
      url: https://api.uhc.com/fhir/R4/Organization
      params:
      - name: name
        value: ''
        type: query
        description: Organization name search
      - name: type
        value: ''
        type: query
        description: Organization type code
      - name: address-state
        value: ''
        type: query
        description: State code filter
      - name: _count
        value: ''
        type: query
        description: Maximum number of results
    docs: Search the UnitedHealthcare FHIR R4 Provider Directory for healthcare organizations including hospitals, medical
      groups, and specialty facilities. Supports filtering by organization type, name, and location. Implements Da Vinci PDex
      Plan Net IG.
- info:
    name: Drug Formulary
    type: folder
  items:
  - info:
      name: UnitedHealth Group List Formulary Drug Coverage
      type: http
    http:
      method: GET
      url: https://api.uhc.com/fhir/R4/MedicationKnowledge
      params:
      - name: code
        value: ''
        type: query
        description: RxNorm drug code
      - name: drug-name
        value: ''
        type: query
        description: Drug name search string
      - name: tier
        value: ''
        type: query
        description: Formulary tier number filter
      - name: _count
        value: ''
        type: query
        description: Maximum number of results
    docs: Retrieve drug formulary information from the UnitedHealthcare FHIR R4 Drug Formulary API including coverage tiers,
      formulary status, prior authorization requirements, quantity limits, and step therapy requirements for prescription
      drugs. Implements the Da Vinci Drug Formulary IG.
bundled: true