> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pricemedic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payer Metadata Enrichment

> Enhanced payer and network identification with human-readable names and standardized identifiers

## Overview

This enrichment enhances rate data by:

* **Payer Name Resolution**: Converting payer IDs to official payer names
* **Network Name Resolution**: Converting network keys to network names
* **Standardized Identifiers**: Providing consistent payer and network slugs
* **Hierarchical Relationships**: Creating composite payer-network identifiers

The process ensures that every rate record has clear, readable payer and network identification for analysis and reporting.

## Data Sources

The enrichment uses PriceMedic's payer and network registry data for official names and standardized identifiers.

## Output Schema

The enrichment produces 6 columns providing comprehensive payer and network metadata:

| Field              | Description                                     | Example                                    |
| ------------------ | ----------------------------------------------- | ------------------------------------------ |
| `payer_name`       | Official name of the insurance payer            | "Aetna Better Health", "Anthem Blue Cross" |
| `payer_id`         | Standardized payer identifier slug              | "aetna-better-health"                      |
| `network_name`     | Human-readable network name                     | "Choice Plus", "PPO Network"               |
| `network_id`       | Original network identifier from source data    | "choice-plus-network"                      |
| `payer_network_id` | Composite identifier linking payer with network | "aetna-better-health/choice-plus"          |

## Processing Logic

The enrichment performs straightforward lookups against comprehensive payer and network registries to convert cryptic identifiers into user-friendly names. The system matches payer IDs from rate data against the payer registry to retrieve official insurance company names and standardized identifier slugs. Similarly, it matches network keys against the network registry to obtain readable network names.

The process creates composite payer-network identifiers by concatenating standardized slugs, enabling granular identification of specific payer-network combinations. All original identifiers are preserved alongside the enhanced metadata to maintain data lineage and support validation workflows.