> 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-feeds-dataset/cms-data-feeds-catalog/footnote-crosswalk.md).

# Footnote Crosswalk

Part of the [CMS Data Feeds Dataset](/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog.md) › Medicare

Dataplex delivers this CMS feed as the analysis-ready table `DWV.FOOTNOTE_CROSSWALK` on Snowflake and Databricks — three snapshot releases spanning 2022–2025, aligned to a single 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.FOOTNOTE_CROSSWALK`                             |
| **Databricks**     | `cms_dwv.footnote_crosswalk`                         |
| **Update pattern** | Full-refresh — each file replaces the prior snapshot |
| **CMS published**  | 2025-09-18                                           |
| **Loaded**         | 2025-11-28                                           |
| **Columns**        | 2 data + 6 lineage                                   |
| **File versions**  | 3                                                    |
| **License**        | CMS public data — U.S. Government work               |
| **Platforms**      | Snowflake Marketplace · Databricks Delta Sharing     |

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

{% hint style="success" %}
**Current** — CMS last published this feed on 2025-09-18. Coverage runs through 2025-09-18. Next CMS release expected \~Dec 2027.
{% endhint %}

{% hint style="info" %}
**Full-refresh feed** — each file version is a complete snapshot and newer files supersede older ones. Filter to the latest file (see the sample query) to avoid double-counting across versions.
{% endhint %}

## Sample queries

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

```sql
-- Latest snapshot only (avoids double-counting across file versions)
SELECT *
FROM DWV.FOOTNOTE_CROSSWALK
WHERE FILE_ID IN (
  SELECT ID FROM DWV.FEEDS_FILES WHERE IS_LATEST = 1
)
LIMIT 100;
```

{% endtab %}

{% tab title="Databricks" %}

```sql
-- Latest snapshot only (avoids double-counting across file versions)
SELECT *
FROM cms_dwv.footnote_crosswalk
WHERE file_id IN (
  SELECT id FROM cms_dwv.feeds_files WHERE is_latest = 1
)
LIMIT 100;
```

{% endtab %}
{% endtabs %}

## About this feed

> The footnote crosswalk displays a list of footnotes and their summary.
>
> — *Source: CMS feed metadata*

**Keywords:** Medicare, Footnote Crosswalk **Theme:** Medicare

## Coverage timeline

2022 🟩 · 2023 ⬜ · 2024 ⬜ · 2025 🟩

2 of 4 years with snapshot releases — gaps: 2023, 2024.

## Release history

| Reporting period          | CMS published | Loaded     | Latest file |
| ------------------------- | ------------- | ---------- | ----------- |
| Snapshot as of 2025-09-18 | 2025-09-18    | 2025-11-28 | ✓           |
| Snapshot as of 2025-01-13 | 2025-01-13    | 2025-02-27 |             |
| Snapshot as of 2022-10-04 | 2022-10-04    | 2024-12-14 |             |

## Data dictionary

<details>

<summary>📋 <strong>2 data columns + 6 lineage columns</strong></summary>

Column-level definitions are maintained by CMS in the official [Footnote Crosswalk data dictionary](https://data.cms.gov/provider-data/dataset/y9us-9xdf).

**Data columns**

| Column          | Type |
| --------------- | ---- |
| `FOOTNOTE`      | TEXT |
| `FOOTNOTE_TEXT` | TEXT |

**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            |
| `CREATED_AT`   | TIMESTAMP\_NTZ | Timestamp when the record was loaded         |

</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{ FOOTNOTE_CROSSWALK : "ID = FILE_FEED_ID"
    FEEDS_FILES ||--o{ FOOTNOTE_CROSSWALK : "ID = FILE_ID"

    FEEDS {
        text ID PK
        text TITLE
        text VIEW_NAME
        text ACCURAL_PERIODICITY
    }
    FEEDS_FILES {
        text ID PK
        text FEED_ID FK
        date TEMPORAL_START
        date TEMPORAL_END
        date CMS_FEED_MODIFIED
        number IS_LATEST
    }
    FOOTNOTE_CROSSWALK {
        text ROW_ID PK
        text FILE_ID FK
        text FILE_FEED_ID FK
        text FOOTNOTE
        text FOOTNOTE_TEXT
    }
```

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

```sql
SELECT d.FOOTNOTE, d.FOOTNOTE_TEXT,
       ff.TEMPORAL_START, ff.TEMPORAL_END, ff.CMS_FEED_MODIFIED
FROM DWV.FOOTNOTE_CROSSWALK d
JOIN DWV.FEEDS_FILES ff ON d.FILE_ID = ff.ID;
```

## Source & provenance

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

* [Official CMS documentation](https://data.cms.gov/provider-data/dataset/y9us-9xdf)

## Frequently asked questions

### How often is Footnote Crosswalk updated?

CMS last published this feed on 2025-09-18. New releases are added automatically when CMS publishes them.

### What years does Footnote Crosswalk cover?

2022 through 2025. Coverage gaps: 2023, 2024.

### How many records are in Footnote Crosswalk?

Count the current snapshot yourself once the share is mounted:

```sql
SELECT COUNT(*)
FROM DWV.FOOTNOTE_CROSSWALK d
JOIN DWV.FEEDS_FILES ff ON d.FILE_ID = ff.ID
WHERE ff.IS_LATEST = 1;
```

### How do I get Footnote Crosswalk data?

It's included in the CMS Data Feeds Dataset on the [Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT1Z125KDH/dataplex-consulting-data-products-cms-data-feeds-dataset) (free trial available) and via [Databricks Delta Sharing](https://checkout.dataplex-consulting.com/b/3cIdR2e1J59Sh2w7pWbQY00). Once mounted, query `DWV.FOOTNOTE_CROSSWALK` directly — no pipeline setup required.

## Related feeds

{% content-ref url="/pages/QsI8YoIQAdwShgdOyn3S" %}
[Hospital Enrollments](/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog/hospital-enrollments.md)
{% endcontent-ref %}

{% content-ref url="/pages/0JExrAkXSJtHUfvuwdBJ" %}
[Medicare Post-Acute Care Utilization - Skilled Nursing Facility by Geography and Provider](/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog/medicare-post-acute-care-utilization-skilled-nursing-facility-by-geography-and-provider.md)
{% endcontent-ref %}

{% content-ref url="/pages/rbWJsiOOm1fFT4s84H9g" %}
[Medicare Physician & Other Practitioners - by Geography and Service](/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog/medicare-physician-other-practitioners-by-geography-and-service.md)
{% endcontent-ref %}

{% content-ref url="/pages/cBK8NrMuryr8GFASWCEb" %}
[Revalidation Due Date List](/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog/revalidation-due-date-list.md)
{% endcontent-ref %}

{% content-ref url="/pages/IDotGkSJWUzBf5pCTU71" %}
[Ambulatory Surgical Center Quality Measures - National](/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog/ambulatory-surgical-center-quality-measures-national.md)
{% endcontent-ref %}

## Get this feed

1. [Start a free trial on Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT1Z125KDH/dataplex-consulting-data-products-cms-data-feeds-dataset) or purchase via [Databricks](https://checkout.dataplex-consulting.com/b/3cIdR2e1J59Sh2w7pWbQY00)
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 Feeds Dataset](/data-catalog/cms-data-feeds-dataset.md) — 280+ feeds · 245B+ records · updated daily. [Back to the full catalog →](/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog.md#footnote-crosswalk)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dataplex-consulting.com/data-catalog/cms-data-feeds-dataset/cms-data-feeds-catalog/footnote-crosswalk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
