{
  "api": "urgentcaremap.health Public API",
  "version": "v1",
  "status": "stable",
  "release_date": "2026-05-01",
  "base_url": "https://urgentcaremap.health/api/v1",
  "documentation": "https://urgentcaremap.health/developers/",
  "openapi_spec": "https://urgentcaremap.health/api/openapi.json",
  "license": "CC-BY-4.0",
  "attribution": "Data from urgentcaremap.health (Lorynec, 2026)",
  "authentication": "None — public API, free to use",
  "rate_limit": "Hosted on Cloudflare Pages — generous free tier, fair-use policy",
  "cors": "All origins allowed",
  "contact": "https://urgentcaremap.health/contact/",
  "endpoints": {
    "meta": {
      "GET /api/v1/index.json": "API metadata (this file)",
      "GET /api/v1/stats.json": "Aggregate statistics across full dataset",
      "GET /api/openapi.json": "OpenAPI 3.0 specification"
    },
    "directory": {
      "GET /api/v1/states.json": "All 50 states + DC with city counts",
      "GET /api/v1/cities.json": "All 386 cities with paths",
      "GET /api/v1/cities/{state}.json": "Cities in a specific state",
      "GET /api/v1/clinics/{state}/{city}.json": "All clinics in a city",
      "GET /api/v1/networks.json": "All 93+ urgent care networks/brands"
    }
  },
  "examples": {
    "get_clinics_in_boston": "https://urgentcaremap.health/api/v1/clinics/massachusetts/boston.json",
    "get_cities_in_california": "https://urgentcaremap.health/api/v1/cities/california.json",
    "get_all_states": "https://urgentcaremap.health/api/v1/states.json"
  },
  "sdks": {
    "python": "https://github.com/LorynecOleksandr/urgentcaremap-cli",
    "javascript": "https://github.com/LorynecOleksandr/urgentcaremap-js",
    "react": "https://github.com/LorynecOleksandr/urgentcaremap-react"
  },
  "datasets": {
    "kaggle": "https://www.kaggle.com/datasets/urgentcaremap/us-urgent-care-centers",
    "huggingface": "https://huggingface.co/datasets/urgentcaremap/us-urgent-care-centers",
    "bulk_download": "https://urgentcaremap.health/developers/data/"
  }
}