Skip to main content

Carrier Crosswalk

The Benefit Plan Standard maintains a carrier crosswalk that maps each issuer’s vocabulary, structure, and terminology into the normalized schema fields.
This ensures that different carriers’ representations of benefits—often inconsistent in naming, structure, and granularity—can be interpreted in a unified, machine-readable way.

Because carriers vary widely in how they describe deductibles, copays, limits, and categories, the crosswalk is a foundational component of the standard.


📊 Live Crosswalk Matrix

Plan Metadata
Normalized FieldBlue CrossGatorCareSCANAetnaUHCCignaHumanaKaiser (future)Molina (future)Oscar (future)
plan_idContract NumberPlan IDH NumberSBC IDPlan NumberPolicy NumberContract ID
carrierFlorida BlueUF Health / GatorCareSCAN Health PlanAetnaUnitedHealthcareCignaHumana
plan_nameBlueOptions 505 PPOPrime PlusClassicPPO 1500 80/50MA Plan NamePreferred PlanGold Plus
plan_typePPOPPOHMO / MAPPOHMO / PPO / MAPPO / HMOHMO / MA
yearCoverage YearPlan YearPlan YearSBC YearPlan YearCalendar YearCalendar Year
marketGroup or IndividualEmployer GroupMedicare AdvantageCommercialCommercial / MACommercialMedicare Advantage
Network Tiers
Normalized FieldBlue CrossGatorCareSCANAetnaUHCCignaHumanaKaiser (future)Molina (future)Oscar (future)
tier_idIN / OUTIN / OUTININ / OUTIN / OUTIN / OUTIN
nameIn / Out of NetworkIn / Out of NetworkIn NetworkIn / Out of NetworkParticipating / Non-ParticipatingIn / Out NetworkIn Network
descriptionNetwork LevelNetwork LevelPlan NetworkNetwork LevelBenefit LevelNetwork TierPlan Network
Accumulators
Normalized FieldBlue CrossGatorCareSCANAetnaUHCCignaHumanaKaiser (future)Molina (future)Oscar (future)
individual_deductibleIndividual DeductibleIndividual DeductibleUsually noneIndividual DeductibleDeductible IN/OUTIndividual DeductibleMostly none
family_deductibleFamily DeductibleFamily DeductibleNoneFamily DeductibleFamily DeductibleFamily DeductibleNot used
individual_oopIndividual OOP MaxOOP Max (Ind.)MOOPOOP Max (Ind.)MOOP IndOOP MaxMOOP
family_oopFamily OOP MaxOOP Max (Family)NoneOOP Max (Family)MOOP FamFamily OOP MaxNot used
Benefits
Normalized FieldBlue CrossGatorCareSCANAetnaUHCCignaHumanaKaiser (future)Molina (future)Oscar (future)
categoryCategory HeaderCategoryCommon Medical EventMedical EventCategoryBenefit CategoryCategory
service_namePCP VisitPrimary Care ProviderPCP VisitPrimary Care VisitPCP Office VisitPCP VisitPrimary Care Physician
place_of_serviceOffice VisitOfficeOfficeOfficeOffice / TelehealthOfficeOffice / Telehealth
deductibleDeductible Applies?Subject to DeductibleDeductible Waived?Subject to DeductibleApplies / WaivedAppliesUsually Waived
copayCopayCopaymentCopayCopayCopayCopayCopay
coinsuranceCoinsuranceCoinsuranceCoinsCoinsuranceCoinsuranceCoinsuranceCoinsurance
Limits
Normalized FieldBlue CrossGatorCareSCANAetnaUHCCignaHumanaKaiser (future)Molina (future)Oscar (future)
typeVisits / DaysVisitsDaysVisitsDays / UnitsVisitsFrequency
valueVisit Limit / Day LimitVisit LimitDay LimitVisit LimitStay LimitVisit LimitAllowance
periodPer Year / Per StayAnnualBenefit PeriodPer YearPer Stay / Per YearPer YearAnnual
Conditions
Normalized FieldBlue CrossGatorCareSCANAetnaUHCCignaHumanaKaiser (future)Molina (future)Oscar (future)
prior_authorizationPrior AuthPrior AuthorizationPrior AuthPrior AuthPrior AuthPrior AuthPrior Auth
referral_requiredReferral RequiredReferral RequiredReferralReferralReferral RequiredReferral RequiredReferral Required
notesNotes / LimitationsLimitationsNotesNotesLimitationsNotesPlan Notes
Source Reference
Normalized FieldBlue CrossGatorCareSCANAetnaUHCCignaHumanaKaiser (future)Molina (future)Oscar (future)
pageSBC PageSBC PageSBC PageSBC PageSBC / EOC PageSBC PageSBC/EOC Page
excerptText SnippetText SnippetSnippetSnippetSnippetSnippetSnippet
Field Definitions
FieldTypeDescription
plan_idstringNormalized unique identifier of the plan
carrierstringCarrier or issuer name
plan_namestringMarketing name
plan_typestringHMO / PPO / EPO / MA
yearintegerCoverage year
marketstringCommercial, MA, Group, etc.
individual_deductiblemoneyDeductible for individual
family_deductiblemoneyDeductible for family
Carrier Vocabulary
FieldTypeDescription
plan_idstringNormalized unique identifier of the plan
carrierstringCarrier or issuer name
plan_namestringMarketing name
plan_typestringHMO / PPO / EPO / MA
yearintegerCoverage year
marketstringCommercial, MA, Group, etc.
individual_deductiblemoneyDeductible for individual
family_deductiblemoneyDeductible for family

Future carriers (e.g., Kaiser, Molina, Oscar, Ambetter) already have placeholder columns for expansion.

Purpose

Carriers do not use consistent terminology.
For example:

  • One carrier may label a row “Office Visit - Primary Care (PCP)”,
    while another writes “Primary Care Provider: You pay $25”,
    and another uses “PCP Copay per encounter”.

  • Deductible applicability might be written as:

    • “After deductible”
    • “Subject to deductible”
    • “Copay does not apply to deductible”
    • “Ded waived”
    • Combined expressions such as “$25 copay + 20% coinsurance after deductible”

Without a standardized crosswalk, ingestion pipelines must be hand-tuned for every carrier.

The crosswalk solves this by documenting, for each normalized field:

  • How each carrier expresses the value
  • Semantics that must be preserved
  • Parsing notes and exceptions
  • Mappings into the normalized JSON structure

Structure of the Crosswalk

The Google Sheet contains multiple tabs, including:

Plan Metadata

Maps identifiers such as:

  • plan_id
  • carrier
  • plan_type
  • market

Network Tiers

Mappings for:

  • In-network / out-of-network naming
  • Tier structures
  • Carrier-specific vocabulary

Accumulators

How each carrier expresses:

  • individual_deductible
  • family_deductible
  • individual_oop
  • family_oop

Benefits

Mappings for:

  • categories
  • service names
  • copays
  • coinsurance expressions
  • deductible applicability

Limits

Mappings for:

  • visit/day limits
  • period definitions (annual, per stay, lifetime, etc.)

Conditions

Mappings for:

  • prior authorization
  • referral requirements
  • contextual notes

Source Reference

Extracts and page references used for ingestion traceability.


Using the Crosswalk

When integrating a new carrier:

1. Identify each benefit entry

Locate the carrier’s terms in the crosswalk (or add them when necessary).

2. Map each value to the normalized field

Examples:

  • Copay differences

    • Blue Cross: “$25 per visit”
    • SCAN: “$0 copay, coinsurance does not apply”
      These map to benefits[].cost_shares.copay.
  • Deductible expressions

    • GatorCare lists medical and pharmacy separately
    • Aetna merges them
      The crosswalk clarifies how to populate individual_deductible, family_deductible, and related fields.

3. Capture exceptions and conditions

Ambiguous phrasing such as:

  • “after facility fee”
  • “per admission deductible”
  • “ded waived for virtual visits”

should be documented in the crosswalk’s notes column.

4. Extend when necessary

If a carrier introduces:

  • new cost-share terminology
  • split benefit categories
  • multi-tier networks

add a row or column to the Google Sheet and update the ingestion rules accordingly.


Updating the Crosswalk

The Google Sheet is the canonical source of truth for carrier mappings.
Updates follow these principles:

  • Accuracy first — No changes without verification against the SBC/EOC.
  • Non-breaking additions — New carriers and vocabulary should not break prior mappings.
  • Schema alignment — Crosswalk rows correspond exactly to the normalized fields.

For contributors assisting with ingestion logic or analysis, edit access may be granted through the governance process.


Summary

The Carrier Crosswalk is essential for:

  • Translating carrier-specific formats into a unified schema
  • Ensuring ingestion is deterministic and predictable
  • Maintaining consistency across carriers
  • Supporting extension as new carriers and plan types are analyzed

The live version ensures that the standard remains current, accurate, and interoperable across all benefit plan formats and carriers.