# SeniorPulse AI-synthesized senior care intelligence API. All endpoints require x402 micropayment (USDC on Base mainnet) via PAYMENT-SIGNATURE header. Returns structured JSON. ## Endpoints GET /api/senior/medicare?zip=78701&situation=turning+65 Returns: Original Medicare vs. Advantage comparison, Medigap analysis, Part D guidance, enrollment deadlines, SHIP counseling referral. Price: $0.15 USDC GET /api/senior/facility?type=assisted-living&location=Austin+TX&budget=5000 Returns: Facility type comparison, cost ranges, evaluation checklist, red flags, questions to ask, A Place for Mom link, CMS Care Compare link. Valid types: assisted-living, memory-care, skilled-nursing, independent-living, home-care Price: $0.15 USDC GET /api/senior/meds?medications=metformin,lisinopril,aspirin,diphenhydramine&age=74 Returns: Beers Criteria flags, drug interaction warnings, geriatric dosing concerns, black box warnings, questions for pharmacist. Uses FDA drug label API. Price: $0.10 USDC GET /api/senior/benefits?state=Texas&income=1200&assets=15000&veteran=false Returns: Likely eligible programs (SSI, Medicaid, Medicare Savings, VA, PACE), income/asset thresholds, how to apply, BenefitsCheckUp.org referral. Price: $0.10 USDC GET /api/senior/caregiver?situation=caring+for+85yo+mother+with+dementia&location=Austin+TX Returns: Legal document checklist (POA, healthcare proxy, advance directive), respite options, local resources, burnout prevention, Amazon product links. Price: $0.10 USDC GET /api/senior/legal?state=Texas&situation=parents+have+no+POA&has_poa=false&capacity_concern=false Returns: Elder-law document guidance by state — power of attorney, healthcare proxy, advance directive, and guardianship: what each does and when it's needed. Estate planning services referral. Price: $0.10 USDC GET /api/senior/memory?mmse_score=20&diagnosis=Alzheimer's¤t_living=with+spouse Returns: Dementia stage and care-trajectory planning from MMSE, MoCA, or CDR scores — clinical staging mapped to care needs and a planning checklist. Price: $0.10 USDC GET /api/senior/nh-compare?facilities=Sunrise+Senior+Living+Austin,Brookdale+South+Austin&zip=78701 Returns: Nursing-home quality comparison using CMS Care Compare data — ranks facilities on inspection, staffing, and quality measures. Price: $0.15 USDC GET /api/senior/veterans?veteran_age=78&care_cost=3500&income=2200&assets=40000&surviving_spouse=false Returns: VA Aid & Attendance eligibility assessment for wartime veterans and surviving spouses — income/asset/care-cost analysis, AARP and medical alert device links. Price: $0.15 USDC GET /api/senior/rx-assist?state=Florida&medications=Eliquis,Jardiance&income=1800&on_medicare=true Returns: Prescription assistance programs by state — Medicare Extra Help, state pharmaceutical programs, and manufacturer patient-assistance programs, with additional Rx savings links. Price: $0.10 USDC GET /api/senior/snap-utility?state=Ohio&income=1100&household_size=1&own_home=true&medical_expenses=200 Returns: SNAP and LIHEAP food/utility assistance eligibility by state, including senior-specific medical expense deductions that raise SNAP eligibility. Price: $0.10 USDC GET /api/senior/property-tax?state=Texas&age=68&income=28000&home_value=320000&veteran=false Returns: Senior property-tax exemptions, assessment freezes, deferrals, and circuit breakers by state, with estimated annual savings. Price: $0.08 USDC GET /api/senior/grief?situation=spouse+passed+3+days+ago&state=Texas&days_since=3 Returns: After-death checklist for family and caregivers — immediate estate steps, survivor benefits to claim, and grief-support resources, calibrated to time since loss. Price: $0.10 USDC GET /api/senior/pension-intl?country=United+Kingdom&topic=abroad&age=64 Returns: International state/public pension guidance — eligibility, amount, and claiming-timing for UK State Pension, Canada CPP/OAS/GIS, Australia Age Pension + Superannuation, Germany, India, and Japan pension systems, plus cross-border portability and totalization (social security) agreement analysis for anyone retiring abroad. Price: $0.15 USDC ## Parameters All endpoints support ?lang= for any language (Claude responds natively). US-framework endpoints (medicare, benefits, property-tax, rx-assist, snap-utility, veterans, nh-compare) accept an optional ?country= parameter. Omit it for US programs; pass a country (e.g. country=Canada) to get that country's equivalent programs instead of US-specific answers. Use /api/senior/pension-intl directly for public pension questions in any country. ## Payment Send GET without PAYMENT-SIGNATURE to receive 402 + payment requirements. Sign payment and retry with PAYMENT-SIGNATURE header. Payment settles on Base mainnet (USDC). Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc ## Data Sources - FDA Drug Label API (free, no key): drug interactions, geriatric use warnings, black box warnings, Beers Criteria context - Tavily: Medicare plan context, local facility ratings, benefits eligibility by state, caregiver resources ## Discovery - OpenAPI: /openapi.json - Agent discovery: /.well-known/agent.json ## Important All endpoints include strong disclaimers. SeniorPulse provides information only — not medical, legal, or financial advice. /api/senior/meds is especially safety-critical and always recommends pharmacist/physician consultation. ## Network Part of PulseNetwork — 15+ specialized intelligence APIs.