# get_landscape Get Landscape · v0.5.0 · medicare Returns the CMS Landscape view of a Medicare plan: monthly premium, in-network MOOP, overall star rating, plan type, and the county/state service-area breadth. Filter by contract_id (required) + optional plan_id (1 to 3 digits, zero-padded), segment_id and year; omit plan_id to list all plans on a contract. RETURNS a detail payload, not a plan-year count: value.plans is the actual PLAN LIST, ONE ROW PER PLAN SEGMENT (report_year, plan_id, segment_id, segment_count, plan_name, org_name, parent_org_name, plan_type, category, snp_type, total_premium, total_premium_basis, premium_as_filed, consolidated_premium, part_c_premium, part_d_premium, moop_in_network, overall_star_rating, overall_star_status, service_area_county_count / state_count), sorted premium ascending so the cheapest lead; value.summary rolls it up (plan_count = distinct plans, segment_row_count, segmented_plan_count, total premium min / median / max, zero-premium count, premium basis counts, star min / max, total distinct counties); value.row_counts carries matched / returned / truncated and value.query the filters applied. `limit` bounds the row list (default 200, max 2000); a truncated list always carries a caveat. READING THE PREMIUM. total_premium is the plan's monthly premium on one basis per row, named in total_premium_basis: 'consolidated' (CMS's Part C plus Part D figure), 'part_c_only_no_drug_coverage' (from CY2025 CMS prints the consolidated premium as 'Not Applicable' on every plan without drug coverage, so the Part C premium is the whole premium), 'part_d_only' (a PDP), or null when CMS filed no figure. CMS's own text is carried in premium_as_filed; its '$-' token (CY2014, 2015, 2019-2023) is a $0 premium, never missing. A segment is its own filed design: a segmented plan has one row per segment with its own premium and MOOP. Covers ALL plan categories (MA, PDP, SNP, MMP, Cost), 2007-2027; the CY2027 file loaded 2026-09-28. The Landscape drops ~early September, ahead of the October benefits drop, so it is the first official view of the upcoming plan year. Stars for 2013-2020 are read from CMS's text form ('3.5 Stars'); a CMS message in place of a star is carried in overall_star_status. Pair with get_pbp_benefit (benefits) for the full picture. A contract / plan / year with no Landscape rows returns found=false with a not_found_reason. SOURCE: CMS MA/Part-D Landscape source files. **Inputs.** - `contract_id` (required): - `plan_id`: - `segment_id`: - `year`: - `limit`: **A real answer** (customer seat, 2.45 s, args `{"contract_id":"H1036","year":2026,"limit":5}`): ```json { "value": { "found": true, "not_found_reason": null, "summary": { "contract_id": "H1036", "plan_id": null, "segment_id": null, "years_covered": [ 2026 ], "plan_count": 86, "segment_row_count": 88, "segmented_plan_count": 2, "org_name": "Humana", "parent_org_name": "Humana Inc.", "categories": [ "MA", "SNP" ], "plan_types": [ "HMO", "HMO C-SNP", "HMO D-SNP", "HMO-POS" ], "total_premium_min": 0.0, "total_premium_median": 0.0, "total_premium_max": 38.4, "total_premium_basis_counts": { "consolidated": 85, "part_c_only_no_drug_coverage": 3 }, "consolidated_premium_min": 0.0, "consolidated_premium_median": 0.0, "consolidated_premium_max": 38.4, "zero_premium_plan_count": 78, "plans_missing_premium": 0, "moop_in_network_min": 500.0, "moop_in_network_max": 9250.0, "overall_star_rating_min": 4.5, "overall_star_rating_max": 4.5, "overall_star_statuses": [], "max_service_area_county_count": 118, "unit": "landscape_plan_segment_rows" }, "plans": [ { "report_year": 2026, "category": "MA", "contract_id": "H1036", "plan_id": "025", "segment_id": "000", "org_name": "Humana", "parent_org_name": "Humana Inc.", "plan_name": "Humana Gold Plus H1036-025 (HMO)", "plan_type": "HMO", "snp_type": null, "part_d_coverage_indicator": "Yes", "premium_as_filed": "$0.00", "consolidated_premium": 0.0, "part_c_premium": 0.0, "part_d_premium": 0.0, "moop_in_network": 2000.0, "overall_star_rating": 4.5, "overall_star_status": null, "service_area_county_count": 4, "service_area_state_count": 1, "total_premium": 0.0, "total_premium_basis": "consolidated", "segment_count": 1 }, { "report_year": 2026, "category": "MA", "contract_id": "H1036", "plan_id": "044", "segment_id": "000", "org_name": "Humana", "parent_org_name": "Humana Inc.", "plan_name": "Humana Gold Plus H1036-044 (HMO)", "plan_type": "HMO", "snp_type": null, "part_d_coverage_indicator": "Yes", "premium_as_filed": "$0.00", "consolidated_premium": 0.0, "part_c_premium": 0.0, "part_d_premium": 0.0, "moop_in_network": 2700.0, "overall_star_rating": 4.5, "overall_star_status": null, "service_area_county_count": 2, "service_area_state_count": 1, "total_premium": 0.0, "total_premium_basis": "consolidated", "segment_count": 1 }, { "report_year": 2026, "category": "MA", "contract_id": "H1036", "plan_id": "054", "segment_id": "000", "org_name": "Humana", "parent_org_name": "Humana Inc.", "plan_name": "Humana Gold Plus H1036-054C (HMO)", "plan_type": "HMO", "snp_type": null, "part_d_coverage_indicator": "Yes", "premium_as_filed": "$0.00", "consolidated_premium": 0.0, "part_c_premium": 0.0, "part_d_premium": 0.0, "moop_in_network": 500.0, "overall_star_rating": 4.5, "overall_star_status": null, "service_area_county_count": 1, "service_area_state_count": 1, "total_premium": 0.0, "total_premium_basis": "consolidated", "segment_count": 1 }, { "report_year": 2026, "category": "MA", "contract_id": "H1036", "plan_id": "062", "segment_id": "000", "org_name": "Humana", "parent_org_name": "Humana Inc.", "plan_name": "Humana Gold Plus H1036-062C (HMO)", "plan_type": "HMO", "snp_type": null, "part_d_coverage_indicator": "Yes", "premium_as_filed": "$0.00", "consolidated_premium": 0.0, "part_c_premium": 0.0, "part_d_premium": 0.0, "moop_in_network": 1625.0, "overall_star_rating": 4.5, "overall_star_status": null, "service_area_county_count": 1, "service_area_state_count": 1, "total_premium": 0.0, "total_premium_basis": "consolidated", "segment_count": 1 }, { "report_year": 2026, "category": "MA", "contract_id": "H1036", "plan_id": "065", "segment_id": "000", "org_name": "Humana", "parent_org_name": "Humana Inc.", "plan_name": "Humana Gold Plus H1036-065C (HMO)", "plan_type": "HMO", "snp_type": null, "part_d_coverage_indicator": "Yes", "premium_as_filed": "$0.00", "consolidated_premium": 0.0, "part_c_premium": 0.0, "part_d_premium": 0.0, "moop_in_network": 1000.0, "overall_star_rating": 4.5, "overall_star_status": null, "service_area_county_count": 1, "service_area_state_count": 1, "total_premium": 0.0, "total_premium_basis": "consolidated", "segment_count": 1 } ], "row_counts": { "plans": { "matched": 88, "returned": 5, "truncated": true, "limit": 5, "kept": "head" } }, "query": { "contract_id": "H1036", "plan_id": null, "segment_id": null, "year": 2026, "limit": 5 }, "query_id": "17f12f65-4469-41b8-ae46-fdb1d77f6311" }, "unit": "landscape_detail", "result_status": "answered_with_caveats", "methodology_era": null, "methodology_blend_factors": null, "source": { "source_url": "medicare://get_landscape" }, "vintage": "as_restated", "cms_vintage_sequence": 1, "parse_revision": 1, "as_of_observed": null, "as_of_asserted": null, "as_of_effective": null, "caveats": [ { "caveat_type": "methodology_note", "severity": "info", "message": "The Landscape is the consumer view (categories MA, PDP, SNP, MMP and Cost). Premium, MOOP and star are the values the plan filed, not adjudicated experience; the benefit tool carries the cost-share detail. The total premium is the monthly premium on the basis named beside it: the consolidated figure CMS filed, the Part C premium alone where the plan has no drug coverage, or the Part D premium alone for a drug plan. The premium as filed is CMS's own text, where the token '$-' is a $0 premium. The county count is the distinct counties in the Landscape file for that pla ... (truncated) ``` REST: `POST https://api.vladahealth.com/v1/tools/get_landscape` with the inputs as the JSON body. MCP: the tool by name.