> For the complete documentation index, see [llms.txt](https://docs.dataplex-consulting.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dataplex-consulting.com/data-catalog/cms-data-research-dataset/cms-data-research-catalog/benefits-data-vbid-general.md).

# Benefits Data - VBID General

VBID general data, one row per plan; published CY2022-CY2026 (VBID discontinued by CMS effective CY2026).

Part of the [CMS Data Research Dataset](/data-catalog/cms-data-research-dataset/cms-data-research-catalog.md) › Plan Benefits

Dataplex delivers this CMS research table as the analysis-ready table `DWV.BENEFITS_DATA__VBID` on Snowflake and Databricks: coverage from 2022 to 2026 in a single aligned schema, refreshed automatically whenever CMS publishes a new file. Every row carries lineage back to the exact CMS source file that produced it.

## Key facts

|                          |                                                       |
| ------------------------ | ----------------------------------------------------- |
| **Snowflake**            | `DWV.BENEFITS_DATA__VBID`                             |
| **Databricks**           | `cms_research_dwv.benefits_data__vbid`                |
| **Coverage**             | Jan 2022 – Jan 2026                                   |
| **Rows**                 | 75,976 (total across all reporting periods)           |
| **Update pattern**       | Time-partitioned; each file adds one reporting period |
| **Latest report period** | 2026-01-01                                            |
| **Loaded**               | 2026-10-04                                            |
| **Columns**              | 41 data + 5 lineage                                   |
| **Identifiers**          | Contract ID (H-number) · Plan ID                      |
| **File versions**        | 10                                                    |
| **License**              | CMS public data (U.S. Government work)                |
| **Platforms**            | Snowflake Marketplace · Databricks Delta Sharing      |

Included in the CMS Data Research Dataset, [start a free trial on Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT1Z125KDP/dataplex-consulting-data-products-cms-data-research-dataset).

{% hint style="info" %}
**Latest report period Jan 2026**: awaiting the next release. New periods load automatically when CMS publishes.
{% endhint %}

{% hint style="info" %}
**Partitioned by report period**: each file version covers one report period and history is additive. The sample query below returns the latest report period; drop the `WHERE` clause to query the full history.
{% endhint %}

## Sample queries

{% tabs %}
{% tab title="Snowflake" %}

```sql
-- Latest report period only (drop the WHERE clause for the full history)
SELECT *
FROM DWV.BENEFITS_DATA__VBID
WHERE FILE_ID IN (
  SELECT ID FROM DWV.FEEDS_FILES WHERE IS_LATEST = 1
)
LIMIT 100;
```

{% endtab %}

{% tab title="Databricks" %}

```sql
-- Latest report period only (drop the WHERE clause for the full history)
SELECT *
FROM cms_research_dwv.benefits_data__vbid
WHERE file_id IN (
  SELECT id FROM cms_research_dwv.feeds_files WHERE is_latest = 1
)
LIMIT 100;
```

{% endtab %}
{% endtabs %}

## About this feed

> VBID general data, one row per plan; published CY2022-CY2026 (VBID discontinued by CMS effective CY2026). Source file pbp\_vbid.txt, one row per plan (BID\_ID) per release; CMS column names and raw codes unchanged.
>
> *Source: CMS feed metadata*

**Theme:** Plan Benefits

## Coverage timeline

2022 🟩 · 2023 🟩 · 2024 🟩 · 2025 🟩 · 2026 🟩

5 of 5 years covered, no gaps.

## Release history

| Report period | Files | Loaded     | Latest | CMS source                                                                       |
| ------------- | ----- | ---------- | ------ | -------------------------------------------------------------------------------- |
| 2026-01-01    | 1     | 2026-10-04 | ✓      | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2026.zip)                  |
| 2025-01-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2025.zip)                  |
| 2024-10-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2024-quarter-4.zip)        |
| 2024-07-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2024-quarter-3.zip)        |
| 2024-01-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2024-quarter-1.zip)        |
| 2023-10-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2023-quarter-4.zip)        |
| 2023-07-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2023-quarter-3.zip)        |
| 2023-04-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2023-quarter-2.zip)        |
| 2022-04-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2022-quarter-2.zip)        |
| 2022-01-01    | 1     | 2026-10-04 |        | [source ↗](https://www.cms.gov/files/zip/pbp-benefits-2022-updated-07012022.zip) |

## Data dictionary

<details>

<summary>📋 <strong>41 data columns + 5 lineage columns</strong></summary>

**Data columns**

| Column                          | Type   |
| ------------------------------- | ------ |
| `PBP_A_HNUMBER`                 | TEXT   |
| `PBP_A_PLAN_IDENTIFIER`         | TEXT   |
| `SEGMENT_ID`                    | TEXT   |
| `PBP_A_BEN_COV`                 | TEXT   |
| `PBP_A_PLAN_TYPE`               | TEXT   |
| `ORGTYPE`                       | TEXT   |
| `BID_ID`                        | TEXT   |
| `VERSION`                       | TEXT   |
| `PART_D_MODEL_DEMO`             | TEXT   |
| `PART_D_ENHNCD_CVRG_DEMO`       | TEXT   |
| `MRX_VBD_YN`                    | TEXT   |
| `MRX_RAI_OFF_REW_INCENT_YN`     | TEXT   |
| `MRX_RAI_NUM_PARTD_OFFRD`       | TEXT   |
| `MRX_REDUCT_COST_YN`            | TEXT   |
| `MRX_TIER_GROUP_NUM`            | TEXT   |
| `MRX_V_BID_ATTESTATION`         | TEXT   |
| `MRX_RAI_GRP_NAME_REW_1RX`      | TEXT   |
| `MRX_RAI_TYPE_PARTD_REW_1RX`    | TEXT   |
| `MAX_RAI_PARTD_REW_INC_AMT_1RX` | TEXT   |
| `MAX_RAI_FRQ_REW_INCENT_1RX`    | TEXT   |
| `MRX_RAI_FRQ_RI_DESC_1RX`       | TEXT   |
| `MRX_RAI_ELIG_CRIT_1RX`         | TEXT   |
| `MRX_RAI_MEET_ADH_GOAL_YN_1RX`  | TEXT   |
| `MAX_RAI_ANN_PARTD_REW_AMT_1RX` | TEXT   |
| `MRX_RAI_GRP_NAME_REW_2RX`      | TEXT   |
| `MRX_RAI_TYPE_PARTD_REW_2RX`    | TEXT   |
| `MAX_RAI_PARTD_REW_INC_AMT_2RX` | TEXT   |
| `MAX_RAI_FRQ_REW_INCENT_2RX`    | TEXT   |
| `MRX_RAI_FRQ_RI_DESC_2RX`       | TEXT   |
| `MRX_RAI_ELIG_CRIT_2RX`         | TEXT   |
| `MRX_RAI_MEET_ADH_GOAL_YN_2RX`  | TEXT   |
| `MAX_RAI_ANN_PARTD_REW_AMT_2RX` | TEXT   |
| `MRX_RAI_GRP_NAME_REW_3RX`      | TEXT   |
| `MRX_RAI_TYPE_PARTD_REW_3RX`    | TEXT   |
| `MAX_RAI_PARTD_REW_INC_AMT_3RX` | TEXT   |
| `MAX_RAI_FRQ_REW_INCENT_3RX`    | TEXT   |
| `MRX_RAI_FRQ_RI_DESC_3RX`       | TEXT   |
| `MRX_RAI_ELIG_CRIT_3RX`         | TEXT   |
| `MRX_RAI_MEET_ADH_GOAL_YN_3RX`  | TEXT   |
| `MAX_RAI_ANN_PARTD_REW_AMT_3RX` | TEXT   |
| `CONTRACT_YEAR`                 | NUMBER |

**Lineage columns** (present on every feed table)

| Column         | Type   | Description                                 |
| -------------- | ------ | ------------------------------------------- |
| `ROW_ID`       | TEXT   | Unique row ID for this table (PK)           |
| `FILE_ID`      | TEXT   | Source file; joins to `FEEDS_FILES.ID` (FK) |
| `FILE_FEED_ID` | TEXT   | Parent feed; joins to `FEEDS.ID` (FK)       |
| `FILE_NAME`    | TEXT   | Source file name as published by CMS        |
| `ROWNUM`       | NUMBER | Row number within the source file           |

</details>

## Row-level lineage

Every row in this table traces to the exact CMS source file that produced it. The `FILE_ID` column joins to the `FEEDS_FILES` catalog table, and `FILE_FEED_ID` joins to the `FEEDS` master table:

```mermaid
erDiagram
    FEEDS ||--o{ FEEDS_FILES : "ID = FEED_ID"
    FEEDS ||--o{ BENEFITS_DATA__VBID : "ID = FILE_FEED_ID"
    FEEDS_FILES ||--o{ BENEFITS_DATA__VBID : "ID = FILE_ID"

    FEEDS {
        text ID PK
        text TITLE
        text VIEW_NAME
        text FEED_SUBTYPE
    }
    FEEDS_FILES {
        text ID PK
        text FEED_ID FK
        date FILE_REPORT_PERIOD
        text FILE_DOWNLOAD_URL
        number IS_LATEST
    }
    BENEFITS_DATA__VBID {
        text ROW_ID PK
        text FILE_ID FK
        text FILE_FEED_ID FK
        text PBP_A_HNUMBER
        text PBP_A_PLAN_IDENTIFIER
        text SEGMENT_ID
        text PBP_A_BEN_COV
        number remaining_37_data_columns
    }
```

Trace any row back to its source file and reporting period:

{% tabs %}
{% tab title="Snowflake" %}

```sql
SELECT d.PBP_A_HNUMBER, d.PBP_A_PLAN_IDENTIFIER, d.SEGMENT_ID,
       ff.FILE_REPORT_PERIOD AS TEMPORAL_START, ff.FILE_REPORT_PERIOD AS TEMPORAL_END
FROM DWV.BENEFITS_DATA__VBID d
JOIN DWV.FEEDS_FILES ff ON d.FILE_ID = ff.ID;
```

{% endtab %}

{% tab title="Databricks" %}

```sql
SELECT d.pbp_a_hnumber, d.pbp_a_plan_identifier, d.segment_id,
       ff.file_report_period AS temporal_start, ff.file_report_period AS temporal_end
FROM cms_research_dwv.benefits_data__vbid d
JOIN cms_research_dwv.feeds_files ff ON d.file_id = ff.id;
```

{% endtab %}
{% endtabs %}

## Source & provenance

Published by the **Centers for Medicare & Medicaid Services**.

* [Official CMS documentation (MA/Part D contract and enrollment data)](https://www.cms.gov/data-research/statistics-trends-and-reports/medicare-advantagepart-d-contract-and-enrollment-data/benefits-data--vbid)
* [Latest source file from CMS (zip)](https://www.cms.gov/files/zip/pbp-benefits-2026.zip)

## Frequently asked questions

### How often is Benefits Data - VBID General updated?

CMS last published this feed on 2026-01-01. New releases are added automatically when CMS publishes them.

### What years does Benefits Data - VBID General cover?

2022 through 2026.

### How many records are in Benefits Data - VBID General?

75,976 rows across all 10 report periods. Because this feed is partitioned by report period, the full table total is the meaningful count; no deduplication needed.

### How do I get Benefits Data - VBID General data?

It's included in the CMS Data Research Dataset on the [Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT1Z125KDP/dataplex-consulting-data-products-cms-data-research-dataset) (free trial available). Once mounted, query `DWV.BENEFITS_DATA__VBID` directly; no pipeline setup required.

## Related feeds

{% content-ref url="/pages/cXZJJsp5nPsW3A3Pxg0W" %}
[Benefits Data - B19B Skilled Nursing Facility (VBID/UF)](/data-catalog/cms-data-research-dataset/cms-data-research-catalog/benefits-data-b19b-skilled-nursing-facility-vbiduf.md)
{% endcontent-ref %}

{% content-ref url="/pages/esbII1orEjboShuD7M5O" %}
[Benefits Data - Inpatient Hospital (Acute)](/data-catalog/cms-data-research-dataset/cms-data-research-catalog/benefits-data-inpatient-hospital-acute.md)
{% endcontent-ref %}

{% content-ref url="/pages/k8kIkU8rqBH23OVbCRGc" %}
[Benefits Data - B19B Packages (VBID/UF/SSBCI)](/data-catalog/cms-data-research-dataset/cms-data-research-catalog/benefits-data-b19b-packages-vbidufssbci.md)
{% endcontent-ref %}

{% content-ref url="/pages/L6DYHS7sXN41pIAd8CRZ" %}
[Benefits Data - B19B Health Care Professional (VBID/UF)](/data-catalog/cms-data-research-dataset/cms-data-research-catalog/benefits-data-b19b-health-care-professional-vbiduf.md)
{% endcontent-ref %}

{% content-ref url="/pages/9a6jX7zavL11nEVUdT79" %}
[Benefits Data - B19B Ambulance/Transportation (VBID/UF)](/data-catalog/cms-data-research-dataset/cms-data-research-catalog/benefits-data-b19b-ambulancetransportation-vbiduf.md)
{% endcontent-ref %}

## Get this feed

1. [Start a free trial on Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT1Z125KDP/dataplex-consulting-data-products-cms-data-research-dataset)
2. Mount the share; the database and `DWV` schema appear in your account immediately
3. Run the [sample query](#sample-queries) above; no ETL, no pipeline maintenance

Questions about this feed? Contact us at <notifications@dataplex-consulting.com>.

***

Part of the [CMS Data Research Dataset](/data-catalog/cms-data-research-dataset.md); 48 research tables · 25 years of Medicare Advantage & Part D history · updated daily. [Back to the full catalog →](/data-catalog/cms-data-research-dataset/cms-data-research-catalog.md#benefits-data-vbid-general)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dataplex-consulting.com/data-catalog/cms-data-research-dataset/cms-data-research-catalog/benefits-data-vbid-general.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.