{
  "name": "VetPulse",
  "description": "US veterans benefits intelligence API — 10 endpoints covering VA disability ratings, Aid & Attendance pension (up to $2,727/month), TDIU, claim-building strategy, caregiver stipends (PCAFC), GI Bill education benefits, state-specific veteran benefits, VA healthcare priority groups, VA home loan advantages, and veteran discounts. Surfaces benefits most veterans never claim. Returns structured JSON. Requires x402 micropayment (USDC on Base mainnet). All endpoints support any language via ?lang= parameter.",
  "version": "1.1.0",
  "url": "https://vetpulse-five.vercel.app",
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc",
    "price_range_usd": "0.05–0.20"
  },
  "global_coverage": {
    "us": "Full VA benefits coverage — disability compensation, Aid & Attendance, TDIU, GI Bill, VA home loans, healthcare, PCAFC caregiver stipends, state benefits across all 50 states",
    "uk": "Signposting to Veterans UK (gov.uk/veterans-uk) and Armed Forces Compensation Scheme",
    "canada": "Signposting to Veterans Affairs Canada and Disability Award program",
    "australia": "Signposting to DVA (Department of Veterans' Affairs) and Totally and Permanently Incapacitated (TPI) pension"
  },
  "capabilities": [
    "VA disability rating analysis — likely ratings per condition, combined rating math, monthly compensation by rating",
    "PACT Act eligibility — toxic exposure presumptive conditions added 2022",
    "Aid & Attendance pension — eligibility up to $2,727/month for veteran couple; surviving spouse rates",
    "TDIU (Total Disability Individual Unemployability) — schedular and extraschedular pathways",
    "Claim-builder — evidence strategy, nexus letter topics, C&P exam prep, secondary conditions",
    "Caregiver stipend (PCAFC) — $800–$3,300+/month stipend plus CHAMPVA health insurance for caregiver",
    "GI Bill comparison — Chapter 33, 30, 35, 1606; housing allowance; STEM scholarship; Vocational Rehab (Ch. 31)",
    "State veteran benefits — property tax exemptions, tuition waivers, DMV, employment preference, burial benefits by state",
    "VA healthcare — priority group placement, copay schedules, CHAMPVA, community care, dental, mental health",
    "VA home loan — funding fee exemption, no-PMI savings, COE process, entitlement restoration",
    "Veteran discounts — airlines, hotels, retail, dining, national parks, recreation, financial services"
  ],
  "data_sources": [
    "VA.gov public data: benefit rates, eligibility criteria, PCAFC stipend tables (2024)",
    "Tavily real-time synthesis: PACT Act updates, state benefit changes, VA policy news"
  ],
  "endpoints": [
    {
      "path": "/api/vet/disability",
      "method": "GET",
      "description": "VA disability rating analysis — likely rating per condition, combined rating math (VA's whole-person formula), monthly compensation at each combined rating level, PACT Act toxic exposure eligibility, secondary conditions to consider adding, and nexus letter topics. Covers all presumptive conditions including Agent Orange, Camp Lejeune water contamination, burn pit exposure.",
      "required_params": ["conditions"],
      "optional_params": ["service_era", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/vet/claim-builder to build the evidence package for the identified conditions; follow with /api/vet/tdiu if combined rating is 60–69% or one condition is 40%+"
    },
    {
      "path": "/api/vet/aid-attendance",
      "method": "GET",
      "description": "VA Aid & Attendance pension eligibility assessment — most underutilized major VA benefit, worth up to $2,727/month for veteran couple. Covers pension rates by family status, net worth limit ($155,356 in 2024), income calculation with medical deductions, wartime service requirement (90+ days with one wartime day), and 36-month asset transfer look-back period.",
      "required_params": [],
      "optional_params": ["age", "needs", "income", "assets", "care_cost", "surviving_spouse", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with SeniorPulse /api/senior/veterans for surviving spouse; follow with /api/vet/claim-builder for application strategy"
    },
    {
      "path": "/api/vet/tdiu",
      "method": "GET",
      "description": "TDIU (Total Disability Individual Unemployability) eligibility — pays at 100% rate ($3,737/month) regardless of combined rating. Schedular path (60%+ combined or 40%+ single condition) and extraschedular path. Covers income threshold (marginal employment), evidence requirements, IU application process, and concurrent SSDI coordination.",
      "required_params": [],
      "optional_params": ["rating", "work_history", "income", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Use after /api/vet/disability to assess TDIU eligibility based on identified ratings; follow with /api/vet/claim-builder for evidence strategy"
    },
    {
      "path": "/api/vet/claim-builder",
      "method": "GET",
      "description": "Evidence strategy brief for VA disability claims — which medical records to request (VA, private, JTSR), buddy statement guidance, C&P exam preparation tactics, nexus letter topics and structure, secondary conditions worth adding to the claim, and overall claim strategy for maximum approval probability. Highest-value endpoint: prevents the most common claim mistakes.",
      "required_params": ["conditions"],
      "optional_params": ["service_era", "current_rating", "previous_denials", "lang"],
      "price_usd": 0.20,
      "agent_use_case": "on-demand",
      "agent_chaining": "Use after /api/vet/disability to build the evidence package; precedes claim filing — agents building veteran advocacy workflows should call this before any claim submission guidance"
    },
    {
      "path": "/api/vet/caregiver",
      "method": "GET",
      "description": "PCAFC (Program of Comprehensive Assistance for Family Caregivers) eligibility — monthly stipend from $800 to $3,300+/month plus CHAMPVA health insurance for the caregiver, respite care, mental health services, and travel benefits. Covers eligibility (post-9/11 veterans with serious injury/illness), application steps, and what happens if veteran's condition improves.",
      "required_params": [],
      "optional_params": ["relationship", "veteran_needs", "discharge_date", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs naturally with SeniorPulse /api/senior/caregiver for aging veterans; follow with /api/vet/healthcare for CHAMPVA health coverage details"
    },
    {
      "path": "/api/vet/education",
      "method": "GET",
      "description": "GI Bill education benefit comparison — Chapter 33 (Post-9/11), Chapter 30 (Montgomery), Chapter 35 (DEA for dependents), Chapter 1606 (Selected Reserve). Covers monthly housing allowance by school location, tuition coverage limits, Yellow Ribbon Program, STEM scholarship, and Vocational Rehabilitation and Employment (Chapter 31) for service-connected disabilities.",
      "required_params": [],
      "optional_params": ["chapter", "branch", "school_location", "dependents", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Use before /api/vet/state-benefits to find state tuition waivers that stack with GI Bill; pairs with CareerPulse for career transition planning"
    },
    {
      "path": "/api/vet/state-benefits",
      "method": "GET",
      "description": "State-specific veteran benefits for all 50 US states — property tax exemptions (can be worth $5,000–$100,000+ in tax savings), tuition waivers at state universities, state employment preference points, hunting/fishing licenses, DMV benefits (free plates, license fees), burial benefits, and state veterans homes. Most veterans claim fewer than 25% of their state benefits.",
      "required_params": ["state"],
      "optional_params": ["disability_rating", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Always pair with /api/vet/disability — state benefits are often enhanced for veterans with 100% or P&T ratings; follow with SeniorPulse /api/senior/property-tax for additional senior property tax relief"
    },
    {
      "path": "/api/vet/healthcare",
      "method": "GET",
      "description": "VA healthcare eligibility and priority group placement — 8 priority groups determine copay schedules. Covers CHAMPVA for dependents (free care for spouses/dependents of P&T veterans), Community Care Network (outside VA), dental eligibility by disability rating, mental health same-day services, and coordination with Medicare/Medicaid.",
      "required_params": [],
      "optional_params": ["priority_group", "income", "disability_rating", "dependents", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with SeniorPulse /api/senior/medicare for aging veterans coordinating VA healthcare with Medicare; pairs with SeniorPulse /api/senior/meds for veteran medication safety review"
    },
    {
      "path": "/api/vet/home-loan",
      "method": "GET",
      "description": "VA home loan benefit analysis — funding fee exemption for disabled veterans (saves $5,000–$15,000 on average), no PMI savings vs. conventional loan (saves $150–$400/month), COE (Certificate of Eligibility) process, entitlement restoration after prior VA loan use, state first-time buyer programs that stack with VA loan for additional savings.",
      "required_params": [],
      "optional_params": ["disability_rating", "purchase_price", "prior_va_loan", "state", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with PropPulse /api/prop/mortgage for full mortgage analysis; follow with /api/vet/state-benefits to identify state down payment assistance that stacks"
    },
    {
      "path": "/api/vet/discounts",
      "method": "GET",
      "description": "Verified veteran discounts by category — airlines (United, Delta, American, Southwest military fares), hotels (Marriott, Hilton, IHG veteran rates), retail (Home Depot, Lowes, Amazon Prime Military), dining (Applebee's, Golden Corral, Texas Roadhouse), national parks (free lifetime pass for disabled veterans), recreation, and financial services (USAA, Navy Federal, PenFed).",
      "required_params": [],
      "optional_params": ["category", "disability_rating", "lang"],
      "price_usd": 0.05,
      "agent_use_case": "on-demand",
      "agent_chaining": "Chain at end of any benefit discovery workflow — highest volume, lowest cost; good for consumer-facing veteran agents as a value-add endpoint"
    }
  ],
  "example_queries": [
    "GET /api/vet/disability?conditions=tinnitus,PTSD,lumbar+strain&service_era=OEF",
    "GET /api/vet/aid-attendance?age=78&needs=requires+daily+assistance+with+bathing+and+dressing&income=2100&assets=42000&care_cost=3200",
    "GET /api/vet/tdiu?rating=70&work_history=cannot+maintain+substantially+gainful+employment+due+to+PTSD",
    "GET /api/vet/claim-builder?conditions=PTSD,sleep+apnea,hypertension&service_era=Vietnam",
    "GET /api/vet/state-benefits?state=Texas&disability_rating=100",
    "GET /api/vet/caregiver?relationship=spouse&veteran_needs=severe+TBI+requires+24hr+supervision",
    "GET /api/vet/education?chapter=33&school_location=Austin+TX",
    "GET /api/vet/home-loan?disability_rating=30&purchase_price=350000&state=Florida",
    "GET /api/vet/healthcare?disability_rating=70&dependents=true",
    "GET /api/vet/discounts?category=travel&disability_rating=100"
  ],
  "network": "PulseNetwork",
  "sibling_apis": [
    { "name": "SeniorPulse", "url": "https://seniorpulse.vercel.app", "relevance": "Aging veteran care coordination — Medicare + VA healthcare overlap, Aid & Attendance for surviving spouses, memory care, property tax relief" },
    { "name": "WealthPulse", "url": "https://wealthpulse-phi.vercel.app", "relevance": "Retirement planning alongside VA pension; SBP (Survivor Benefit Plan) analysis" },
    { "name": "LegalPulse", "url": "https://legalpulse-rho.vercel.app", "relevance": "Military divorce (USFSPA), VA benefits and bankruptcy, discharge upgrade legal process" },
    { "name": "CareerPulse", "url": "https://careerpulse-steel.vercel.app", "relevance": "Veteran-to-civilian career transition, military skills translation, federal hiring preference (Schedule A, VRA, VEOA)" },
    { "name": "PropPulse", "url": "https://proppulse-gules.vercel.app", "relevance": "Full mortgage analysis to pair with VA home loan benefit assessment" }
  ],
  "openapi": "https://vetpulse-five.vercel.app/openapi.json",
  "llms_txt": "https://vetpulse-five.vercel.app/llms.txt",
  "disclaimer": "Not an official VA determination. For informational purposes only. Consult a VA-accredited VSO, claims agent, or attorney for filing assistance."
}
