{
  "name": "ClearCarePulse",
  "description": "Hospital price transparency intelligence API. Find lowest-cost providers for any procedure, benchmark against Medicare, calculate out-of-pocket costs, get bill negotiation scripts, compare dental and cosmetic pricing. Returns structured JSON. Requires x402 micropayment (USDC on Base mainnet).",
  "version": "1.0.0",
  "url": "https://clearcarepulse.vercel.app",
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc",
    "price_range_usd": "0.10–0.15"
  },
  "capabilities": [
    "Procedure price search — CPT code mapping, lowest-cost providers sorted by cash price, Medicare benchmark",
    "Hospital price lookup — published chargemaster, negotiated rates, cash price, payer breakdown",
    "Total episode cost — surgeon + anesthesia + facility + PT + follow-up broken down component by component",
    "Out-of-pocket calculator — deductible, coinsurance, OOP max, HSA impact, payment strategies",
    "Care site alternatives — ASC vs. hospital, freestanding imaging, urgent care, FQHC, telemedicine",
    "Medical bill negotiation — step-by-step scripts, Medicare benchmark targeting, charity care eligibility",
    "Dental pricing — CDT codes, FairHealth UCR benchmarks, discount plan vs. insurance comparison",
    "Cosmetic procedure costs — ASPS surgeon fee data, total episode breakdown, financing options"
  ],
  "data_sources": [
    "Tavily: real-time hospital price transparency data, CMS Medicare rates, FairHealth benchmarks",
    "Claude synthesis: CPT/CDT code mapping, cost component analysis, negotiation strategy",
    "CMS: Medicare OPPS/MPFS rate benchmarks",
    "ASPS: American Society of Plastic Surgeons 2024 procedure statistics",
    "FairHealth: dental UCR benchmarks by geography",
    "No Surprises Act / ACA price transparency regulations (Jan 2021)"
  ],
  "endpoints": [
    {
      "path": "/api/care/search",
      "method": "GET",
      "description": "Procedure price search — CPT code mapping, providers sorted low-to-high by cash price, Medicare benchmark",
      "required_params": ["procedure", "zip"],
      "optional_params": ["radius", "lang"],
      "price_usd": 0.15
    },
    {
      "path": "/api/care/hospital",
      "method": "GET",
      "description": "Hospital-specific price lookup — chargemaster, negotiated rates, cash price, payer breakdown, negotiation script",
      "required_params": ["hospital", "procedure"],
      "optional_params": ["lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/care/episode",
      "method": "GET",
      "description": "Total episode cost breakdown — surgeon, anesthesia, facility, PT, DME, follow-up; OOP calculation",
      "required_params": ["procedure"],
      "optional_params": ["deductible", "deductible_met", "coinsurance", "oop_max", "lang"],
      "price_usd": 0.15
    },
    {
      "path": "/api/care/oop",
      "method": "GET",
      "description": "Out-of-pocket cost calculator — exact patient liability given deductible, coinsurance, OOP max, HSA",
      "required_params": ["procedure"],
      "optional_params": ["procedure_cost", "plan_type", "deductible", "deductible_met", "coinsurance", "oop_max", "oop_spent", "hsa", "lang"],
      "price_usd": 0.15
    },
    {
      "path": "/api/care/alternatives",
      "method": "GET",
      "description": "Lower-cost care site alternatives — ASC, freestanding imaging, urgent care, FQHC, telemedicine vs. hospital",
      "required_params": ["procedure"],
      "optional_params": ["zip", "current_setting", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/care/negotiate",
      "method": "GET",
      "description": "Medical bill negotiation guide — step-by-step scripts, Medicare benchmark, charity care, billing advocates",
      "required_params": ["procedure"],
      "optional_params": ["bill_amount", "hospital", "insured", "income", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/care/dental",
      "method": "GET",
      "description": "Dental cost intelligence — CDT codes, FairHealth UCR benchmarks, discount plan vs. insurance comparison",
      "required_params": ["procedure"],
      "optional_params": ["zip", "has_insurance", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/care/cosmetic",
      "method": "GET",
      "description": "Cosmetic procedure cost intelligence — ASPS surgeon fee benchmarks, total episode, financing options",
      "required_params": ["procedure"],
      "optional_params": ["location", "lang"],
      "price_usd": 0.10
    }
  ],
  "example_queries": [
    "GET /api/care/search?procedure=knee+MRI&zip=90210&radius=25",
    "GET /api/care/hospital?hospital=Cedars+Sinai&procedure=colonoscopy",
    "GET /api/care/episode?procedure=hip+replacement&deductible=3000&deductible_met=500&coinsurance=20&oop_max=7500",
    "GET /api/care/oop?procedure=cataract+surgery&procedure_cost=3500&deductible=2000&deductible_met=800&coinsurance=20&oop_max=6000",
    "GET /api/care/alternatives?procedure=MRI+shoulder&zip=60601",
    "GET /api/care/negotiate?procedure=appendectomy&bill_amount=28000&hospital=Northwestern+Memorial",
    "GET /api/care/dental?procedure=crown&zip=77001&has_insurance=false",
    "GET /api/care/cosmetic?procedure=rhinoplasty&location=Los+Angeles"
  ],
  "network": "PulseNetwork",
  "sibling_apis": [
    { "name": "SeniorPulse", "url": "https://seniorpulse.vercel.app", "relevance": "Medicare guidance, care facilities, medications for seniors" },
    { "name": "InsurePulse", "url": "https://insurepulse.vercel.app", "relevance": "Health insurance plan selection and coverage optimization" },
    { "name": "WealthPulse", "url": "https://wealthpulse-phi.vercel.app", "relevance": "Medical debt payoff, HSA optimization, financial planning" }
  ],
  "openapi": "https://clearcarepulse.vercel.app/openapi.json",
  "llms_txt": "https://clearcarepulse.vercel.app/llms.txt",
  "disclaimer": "For informational purposes only. Price estimates based on publicly available data. Not medical or financial advice. Verify costs with your provider and insurer."
}