# CMS Medicare Coverage Database reference metadata

`medicare_silver.mcd_reference` · Medicare Advantage, Part D, Medicaid · status live · 270 rows

Public Coverage API reference metadata, including states, update periods, local-data schedule, contractor types and subtypes, and contractor records.

**Grain.** One row per (Coverage API snapshot, public reference endpoint, publisher row ordinal).

| column | type | meaning |
|---|---|---|
| snapshot_date | date |  |
| source_endpoint | string |  |
| record_type | string |  |
| record_ordinal | bigint |  |
| parent_document_type | string |  |
| parent_document_id | string |  |
| parent_document_version | string |  |
| document_type | string |  |
| document_id | string |  |
| document_version | string |  |
| document_display_id | string |  |
| title | string |  |
| status | string |  |
| note | string |  |
| contractor_name_type | string |  |
| publication_number | string |  |
| benefit_category | string |  |
| effective_date_raw | string |  |
| effective_end_date_raw | string |  |
| implementation_date_raw | string |  |
| retirement_date_raw | string |  |
| last_updated_raw | string |  |
| url | string |  |
| payload_json | string |  |
| source_member | string |  |
| source_member_sha256 | string |  |
| quality_flags | string |  |
| is_analytics_eligible | boolean |  |
| observed_period | date |  |
| asserted_at | date |  |
| effective_period_start | date |  |
| effective_period_end | date |  |
| cms_vintage_sequence | int |  |
| parse_revision | int |  |
| parser_artifact_hash | string |  |
| source_url | string |  |
| sha256_content_hash | string |  |
| source_id | string |  |
| is_current | boolean |  |
| bronze_object_key | string |  |
| s3_version_id | string |  |
| vintage_tag | string |  |
| drug_source_version_id | string |  |

Query it: `query_substrate` with `SELECT ... FROM medicare_silver.mcd_reference WHERE ... LIMIT 100`; read `describe_data_source("medicare_silver.mcd_reference")` first.