{
 "name": "HomeCareFinder static API",
 "updated": "2026-10-20",
 "source": "https://data.cms.gov/provider-data/dataset/6jpm-sxkc",
 "release": "July 2026",
 "ranking": "CMS quality-of-patient-care stars desc; ties alphabetical; unrated last; no paid placement",
 "endpoints": {
  "state": "/api/states/{state}.json",
  "city": "/api/cities/{state}/{city-slug}.json",
  "agency_shard": "/api/agencies/{ccn[0:2]}.json (object keyed by CCN)",
  "search_index": "/api/search-index.json",
  "zip_to_cities": "/api/zips.json",
  "openapi": "/openapi.json",
  "home_health_city": "/api/cities/{state}/{city-slug}.json",
  "costs": "/api/costs.json",
  "care_types": "/api/care-types.json",
  "florida": "/api/florida.json",
  "home_care_state": "/api/home-care/ca.json",
  "home_care_city": "/api/home-care/ca/{city-slug}.json",
  "assisted_living_city": "/api/assisted-living/ca/{city-slug}.json",
  "hospice_state": "/api/hospice/{state}.json",
  "hospice_city": "/api/hospice/{state}/{city-slug}.json",
  "nursing_home_state": "/api/nursing-homes/{state}.json",
  "nursing_home_city": "/api/nursing-homes/{state}/{city-slug}.json",
  "mcp": "/mcp",
  "mcp_server_card": "/.well-known/mcp/server.json"
 },
 "states": [
  {
   "state": "AL",
   "name": "Alabama",
   "agency_count": 116,
   "city_count": 73,
   "api": "/api/states/al.json"
  },
  {
   "state": "AK",
   "name": "Alaska",
   "agency_count": 14,
   "city_count": 8,
   "api": "/api/states/ak.json"
  },
  {
   "state": "AZ",
   "name": "Arizona",
   "agency_count": 177,
   "city_count": 34,
   "api": "/api/states/az.json"
  },
  {
   "state": "AR",
   "name": "Arkansas",
   "agency_count": 92,
   "city_count": 55,
   "api": "/api/states/ar.json"
  },
  {
   "state": "CA",
   "name": "California",
   "agency_count": 3213,
   "city_count": 289,
   "api": "/api/states/ca.json"
  },
  {
   "state": "CO",
   "name": "Colorado",
   "agency_count": 222,
   "city_count": 47,
   "api": "/api/states/co.json"
  },
  {
   "state": "CT",
   "name": "Connecticut",
   "agency_count": 72,
   "city_count": 43,
   "api": "/api/states/ct.json"
  },
  {
   "state": "DE",
   "name": "Delaware",
   "agency_count": 22,
   "city_count": 12,
   "api": "/api/states/de.json"
  },
  {
   "state": "DC",
   "name": "District of Columbia",
   "agency_count": 35,
   "city_count": 1,
   "api": "/api/states/dc.json"
  },
  {
   "state": "GA",
   "name": "Georgia",
   "agency_count": 105,
   "city_count": 63,
   "api": "/api/states/ga.json"
  },
  {
   "state": "GU",
   "name": "Guam",
   "agency_count": 3,
   "city_count": 2,
   "api": "/api/states/gu.json"
  },
  {
   "state": "HI",
   "name": "Hawaii",
   "agency_count": 18,
   "city_count": 8,
   "api": "/api/states/hi.json"
  },
  {
   "state": "ID",
   "name": "Idaho",
   "agency_count": 48,
   "city_count": 20,
   "api": "/api/states/id.json"
  },
  {
   "state": "IL",
   "name": "Illinois",
   "agency_count": 530,
   "city_count": 163,
   "api": "/api/states/il.json"
  },
  {
   "state": "IN",
   "name": "Indiana",
   "agency_count": 173,
   "city_count": 64,
   "api": "/api/states/in.json"
  },
  {
   "state": "IA",
   "name": "Iowa",
   "agency_count": 125,
   "city_count": 84,
   "api": "/api/states/ia.json"
  },
  {
   "state": "KS",
   "name": "Kansas",
   "agency_count": 108,
   "city_count": 53,
   "api": "/api/states/ks.json"
  },
  {
   "state": "KY",
   "name": "Kentucky",
   "agency_count": 88,
   "city_count": 56,
   "api": "/api/states/ky.json"
  },
  {
   "state": "LA",
   "name": "Louisiana",
   "agency_count": 176,
   "city_count": 64,
   "api": "/api/states/la.json"
  },
  {
   "state": "ME",
   "name": "Maine",
   "agency_count": 19,
   "city_count": 14,
   "api": "/api/states/me.json"
  },
  {
   "state": "MD",
   "name": "Maryland",
   "agency_count": 51,
   "city_count": 28,
   "api": "/api/states/md.json"
  },
  {
   "state": "MA",
   "name": "Massachusetts",
   "agency_count": 287,
   "city_count": 115,
   "api": "/api/states/ma.json"
  },
  {
   "state": "MI",
   "name": "Michigan",
   "agency_count": 371,
   "city_count": 100,
   "api": "/api/states/mi.json"
  },
  {
   "state": "MN",
   "name": "Minnesota",
   "agency_count": 138,
   "city_count": 92,
   "api": "/api/states/mn.json"
  },
  {
   "state": "MS",
   "name": "Mississippi",
   "agency_count": 42,
   "city_count": 33,
   "api": "/api/states/ms.json"
  },
  {
   "state": "MO",
   "name": "Missouri",
   "agency_count": 120,
   "city_count": 63,
   "api": "/api/states/mo.json"
  },
  {
   "state": "MT",
   "name": "Montana",
   "agency_count": 21,
   "city_count": 13,
   "api": "/api/states/mt.json"
  },
  {
   "state": "NE",
   "name": "Nebraska",
   "agency_count": 62,
   "city_count": 30,
   "api": "/api/states/ne.json"
  },
  {
   "state": "NV",
   "name": "Nevada",
   "agency_count": 228,
   "city_count": 11,
   "api": "/api/states/nv.json"
  },
  {
   "state": "NH",
   "name": "New Hampshire",
   "agency_count": 27,
   "city_count": 20,
   "api": "/api/states/nh.json"
  },
  {
   "state": "NJ",
   "name": "New Jersey",
   "agency_count": 38,
   "city_count": 35,
   "api": "/api/states/nj.json"
  },
  {
   "state": "NM",
   "name": "New Mexico",
   "agency_count": 70,
   "city_count": 24,
   "api": "/api/states/nm.json"
  },
  {
   "state": "NY",
   "name": "New York",
   "agency_count": 100,
   "city_count": 62,
   "api": "/api/states/ny.json"
  },
  {
   "state": "NC",
   "name": "North Carolina",
   "agency_count": 166,
   "city_count": 97,
   "api": "/api/states/nc.json"
  },
  {
   "state": "ND",
   "name": "North Dakota",
   "agency_count": 20,
   "city_count": 12,
   "api": "/api/states/nd.json"
  },
  {
   "state": "MP",
   "name": "Northern Mariana Islands",
   "agency_count": 3,
   "city_count": 2,
   "api": "/api/states/mp.json"
  },
  {
   "state": "OH",
   "name": "Ohio",
   "agency_count": 835,
   "city_count": 183,
   "api": "/api/states/oh.json"
  },
  {
   "state": "OK",
   "name": "Oklahoma",
   "agency_count": 212,
   "city_count": 74,
   "api": "/api/states/ok.json"
  },
  {
   "state": "OR",
   "name": "Oregon",
   "agency_count": 51,
   "city_count": 27,
   "api": "/api/states/or.json"
  },
  {
   "state": "PA",
   "name": "Pennsylvania",
   "agency_count": 415,
   "city_count": 178,
   "api": "/api/states/pa.json"
  },
  {
   "state": "PR",
   "name": "Puerto Rico",
   "agency_count": 39,
   "city_count": 25,
   "api": "/api/states/pr.json"
  },
  {
   "state": "RI",
   "name": "Rhode Island",
   "agency_count": 22,
   "city_count": 8,
   "api": "/api/states/ri.json"
  },
  {
   "state": "SC",
   "name": "South Carolina",
   "agency_count": 68,
   "city_count": 35,
   "api": "/api/states/sc.json"
  },
  {
   "state": "SD",
   "name": "South Dakota",
   "agency_count": 23,
   "city_count": 15,
   "api": "/api/states/sd.json"
  },
  {
   "state": "TN",
   "name": "Tennessee",
   "agency_count": 128,
   "city_count": 56,
   "api": "/api/states/tn.json"
  },
  {
   "state": "TX",
   "name": "Texas",
   "agency_count": 1854,
   "city_count": 275,
   "api": "/api/states/tx.json"
  },
  {
   "state": "VI",
   "name": "U.S. Virgin Islands",
   "agency_count": 3,
   "city_count": 3,
   "api": "/api/states/vi.json"
  },
  {
   "state": "UT",
   "name": "Utah",
   "agency_count": 82,
   "city_count": 38,
   "api": "/api/states/ut.json"
  },
  {
   "state": "VT",
   "name": "Vermont",
   "agency_count": 9,
   "city_count": 8,
   "api": "/api/states/vt.json"
  },
  {
   "state": "VA",
   "name": "Virginia",
   "agency_count": 237,
   "city_count": 83,
   "api": "/api/states/va.json"
  },
  {
   "state": "WA",
   "name": "Washington",
   "agency_count": 74,
   "city_count": 39,
   "api": "/api/states/wa.json"
  },
  {
   "state": "WV",
   "name": "West Virginia",
   "agency_count": 43,
   "city_count": 31,
   "api": "/api/states/wv.json"
  },
  {
   "state": "WI",
   "name": "Wisconsin",
   "agency_count": 87,
   "city_count": 51,
   "api": "/api/states/wi.json"
  },
  {
   "state": "WY",
   "name": "Wyoming",
   "agency_count": 32,
   "city_count": 19,
   "api": "/api/states/wy.json"
  }
 ],
 "layers": {
  "trust": "Medicare home health (CMS data, ranked by CMS stars, never paid)",
  "private_pay": "Home care, assisted living and memory care from state licensing data, alphabetical. Live: CA. Coming soon: TX. No paid links anywhere (free-only release).",
  "cms_more": "Hospices (6,608, CMS August 2026) and nursing homes (13,996, CMS September 2026), ranked only by CMS star ratings, never paid; Florida withheld until 2027-01-01."
 },
 "coming_soon": {
  "TX": "Texas home care, assisted living and memory care city files are not published yet; /api/{home-care|assisted-living|memory-care}/tx.json returns status coming_soon."
 },
 "listing_policy": "The order of our lists can't be bought. Every provider in a list is placed by the same rule, and paying never adds anyone to a list, moves anyone up or down, or removes anyone. If we ever show paid spots, they will be labeled \"Ad\" and shown separately from the list, and they will never change it.",
 "state_gate": {
  "TX": {
   "listings": true,
   "paid_partner_links": false,
   "sponsors": false,
   "legal_status": "needs_attorney"
  },
  "CA": {
   "listings": true,
   "paid_partner_links": false,
   "sponsors": false,
   "legal_status": "needs_attorney"
  },
  "FL": {
   "listings": false,
   "paid_partner_links": false,
   "sponsors": false,
   "legal_status": "blocked"
  },
  "US": {
   "listings": true,
   "paid_partner_links": false,
   "sponsors": false,
   "legal_status": "blocked"
  }
 },
 "florida": {
  "status": "coming",
  "launch": "2027-01-01",
  "notice": "Florida listings are coming January 1, 2027 (2027-01-01). HomeCareFinder does not publish Florida providers, Florida Medicare home health agencies, partner links or sponsors before then."
 }
}