{
  "name": "VetPulse",
  "description": "Global veterans benefits intelligence API — 10 endpoints covering disability ratings, Aid & Attendance-style pensions, TDIU/unemployability, claim-building strategy, family caregiver stipends, education benefits, state/regional veteran benefits, healthcare priority/coverage, home-buying assistance, and veteran discounts. Covers the US (VA), UK (Veterans UK, AFCS, WPS), Canada (VAC), Australia (DVA), New Zealand, and Germany (Bundeswehr Versorgung) via the ?country= parameter, with best-effort support for any other nation. 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.2.0",
  "url": "https://vetpulse.theaslangroupllc.com",
  "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": "AI-synthesized assessment (pass ?country=UK) of Veterans UK, the Armed Forces Compensation Scheme (AFCS), and the War Pension Scheme (WPS) — disability tariffs, care/mobility supplements, Guaranteed Income Payment, and claims process. Note: no direct GI Bill or VA-home-loan analogue exists in the UK.",
    "canada": "AI-synthesized assessment (pass ?country=Canada) of Veterans Affairs Canada (VAC) — Pain and Suffering Compensation, Pension for Life, Diminished Earning Capacity/Income Replacement Benefit, Caregiver Recognition Benefit, and the Education and Training Benefit. Note: no dedicated veteran home-loan program exists in Canada.",
    "australia": "AI-synthesized assessment (pass ?country=Australia) of the Department of Veterans' Affairs (DVA) — Disability Compensation Payment, Gold/White Card healthcare, Totally and Permanently Incapacitated (TPI) pension, Carer Allowance/Payment, and the Defence Home Ownership Assistance Scheme (DHOAS)",
    "new_zealand": "AI-synthesized assessment (pass ?country=NewZealand) of Veterans' Affairs New Zealand — disablement pension, Veteran's Pension, and caregiver/attendant-care support",
    "germany": "AI-synthesized assessment (pass ?country=Germany) of Bundeswehr Versorgung under the Soldatenversorgungsgesetz — Beschädigtenversorgung compensation, Pflegegeld caregiver allowance, and Berufsförderungsdienst vocational training",
    "other_countries": "Best-effort AI-synthesized assessment for any other country passed via ?country= — the response states plainly when it cannot confidently map to a known program rather than defaulting to US rules",
    "cross_border": "Every disability, pension, unemployability, healthcare, and caregiver endpoint also addresses veterans living abroad relative to the country paying their benefit (e.g. a US veteran retired overseas still drawing VA disability)"
  },
  "capabilities": [
    "Veteran disability rating analysis — VA (US), AFCS/WPS (UK), VAC (Canada), DVA (Australia), NZ/Germany; likely ratings per condition, combined rating math, monthly compensation",
    "Presumptive/toxic-exposure eligibility — PACT Act (US) and country-appropriate equivalents",
    "Aid & Attendance-style pension — eligibility for care-needs supplements up to $2,727/month (US) or the local equivalent; surviving spouse rates",
    "TDIU / unemployability — US schedular and extraschedular pathways, Australia's TPI pension, Canada's DEC/IRB, UK's AFCS GIP",
    "Claim-builder — evidence strategy, nexus/causation letter topics, exam prep, secondary conditions, adapted to the country's actual forms and appeal lanes",
    "Family caregiver stipend — US PCAFC ($800–$3,300+/month plus CHAMPVA), Canada's VAC Caregiver Recognition Benefit, Australia's DVA Carer Allowance/Payment, UK/NZ/Germany support",
    "Education benefit comparison — US GI Bill (Ch. 33, 30, 35, 1606, VR&E) and the closest real equivalents in UK, Canada, Australia, NZ, Germany",
    "State/regional veteran benefits — US states, UK devolved nations/local authorities, Canadian provinces, Australian states/territories, NZ/German regions",
    "Veteran healthcare — US priority groups/copays, UK NHS priority care, Canada's VAC benefits, Australia's Gold/White Card, NZ/Germany entitlements",
    "Home-buying assistance — US VA loan, Australia's DHOAS, UK's Forces Help to Buy; honest guidance where no veteran-specific program exists (Canada, NZ, Germany)",
    "Veteran discounts — US retail/travel/national parks, UK Defence Discount Service/Blue Light Card, Australia RSL, NZ RSA",
    "Cross-border guidance — veterans living abroad relative to the country paying their benefit"
  ],
  "data_sources": [
    "Government public data: VA.gov (US), gov.uk/veterans-uk (UK), veterans.gc.ca (Canada), dva.gov.au (Australia) — benefit rates and eligibility criteria",
    "Tavily real-time synthesis: PACT Act and equivalent policy updates, state/regional benefit changes, veterans-affairs policy news across covered countries"
  ],
  "endpoints": [
    {
      "path": "/api/vet/disability",
      "method": "GET",
      "description": "Veteran disability rating analysis — likely rating per condition and monthly compensation under the VA (US), AFCS/WPS (UK), VAC (Canada), DVA (Australia), or New Zealand/Germany system specified via ?country=. Covers presumptive/toxic-exposure conditions (e.g. US PACT Act), secondary conditions to consider adding, and nexus/causation letter topics.",
      "required_params": ["conditions"],
      "optional_params": ["service_era", "country", "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": "Veteran pension / Aid & Attendance-style eligibility assessment — most underutilized major VA benefit (US), worth up to $2,727/month for veteran couple, or the equivalent care-needs allowance under UK AFCS/WPS, Canada's VAC Attendance Allowance, Australia's DVA attendant-care support, or New Zealand/Germany systems via ?country=. Covers pension rates by family status, net worth/income limits, medical deductions, and qualifying service period.",
      "required_params": [],
      "optional_params": ["age", "needs", "income", "assets", "care_cost", "surviving_spouse", "country", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with SeniorPulse for surviving spouse benefits; follow with /api/vet/claim-builder for application strategy"
    },
    {
      "path": "/api/vet/tdiu",
      "method": "GET",
      "description": "TDIU (US Total Disability Individual Unemployability) eligibility — pays at 100% rate regardless of combined rating — or the closest equivalent via ?country=: Australia's TPI pension, Canada's Diminished Earning Capacity/Income Replacement Benefit, UK's AFCS Guaranteed Income Payment, or New Zealand/Germany systems. Schedular and extraschedular paths, income threshold, evidence requirements, and application process.",
      "required_params": [],
      "optional_params": ["rating", "work_history", "income", "country", "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 veteran disability claims — which records to request, buddy/witness statement guidance, exam preparation tactics, nexus/causation letter topics, secondary conditions worth adding, and overall claim strategy adapted to the VA (US), Veterans UK/AFCS, VAC (Canada), DVA (Australia), or New Zealand/Germany process via ?country=. Highest-value endpoint: prevents the most common claim mistakes.",
      "required_params": ["conditions"],
      "optional_params": ["service_era", "current_rating", "previous_denials", "country", "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 (US Program of Comprehensive Assistance for Family Caregivers) eligibility — monthly stipend from $800 to $3,300+/month plus CHAMPVA, respite care, and travel benefits — or the equivalent via ?country=: Canada's VAC Caregiver Recognition Benefit, Australia's DVA Carer Allowance/Payment, or UK/New Zealand/Germany caregiver support. Covers eligibility, application steps, and what happens if the veteran's condition improves.",
      "required_params": [],
      "optional_params": ["relationship", "veteran_needs", "discharge_date", "country", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs naturally with SeniorPulse for aging veterans; follow with /api/vet/healthcare for CHAMPVA health coverage details"
    },
    {
      "path": "/api/vet/education",
      "method": "GET",
      "description": "GI Bill (US) education benefit comparison — Chapter 33, 30, 35, 1606, and Vocational Rehabilitation (Chapter 31) — or the closest real equivalent via ?country=: UK Enhanced/Standard Learning Credits, Canada's VAC Education and Training Benefit, Australia's DVA education schemes, or New Zealand/Germany vocational-training support. The GI Bill's scale has no exact foreign equivalent; non-US responses name the real program and are direct about scope.",
      "required_params": [],
      "optional_params": ["chapter", "branch", "school_location", "dependents", "country", "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/regional veteran benefits — all 50 US states (property tax exemptions, tuition waivers, employment preference, DMV/hunting-fishing benefits, burial benefits, state veterans homes) or the equivalent sub-national programs via ?country=: UK devolved nations/local authorities, Canadian provinces, Australian states/territories, or New Zealand/German regions. Most veterans claim fewer than 25% of their regional benefits.",
      "required_params": ["state"],
      "optional_params": ["disability_rating", "country", "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 (US) eligibility and priority group placement — 8 priority groups determine copay schedules — or the equivalent via ?country=: UK NHS veteran priority treatment and Op COURAGE, Canada's VAC health/treatment benefits, Australia's DVA Gold/White Card, or New Zealand/Germany veteran healthcare entitlements. Covers dependent coverage (e.g. CHAMPVA), community/civilian care, dental, mental health, and Medicare/Medicaid coordination.",
      "required_params": [],
      "optional_params": ["priority_group", "income", "disability_rating", "dependents", "country", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with SeniorPulse 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 (US) benefit analysis — funding fee exemption, no PMI savings, COE process, entitlement restoration, and stacking state programs — or the closest real equivalent via ?country=: Australia's DHOAS interest-rate subsidy, or the UK's Forces Help to Buy deposit loan. Canada, New Zealand, and Germany have no dedicated veteran home-loan guaranty; the response says so plainly and points to general first-time-buyer assistance instead.",
      "required_params": [],
      "optional_params": ["disability_rating", "purchase_price", "prior_va_loan", "state", "country", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with PropPulse 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 — US (airlines, hotels, retail, dining, national parks, financial services), or via ?country=: UK (Defence Discount Service, Blue Light Card), Australia (RSL-partner discounts), New Zealand (RSA-partner discounts). Canada and Germany are less centralized; the response surfaces what's verifiable and is honest where no broad program exists.",
      "required_params": [],
      "optional_params": ["category", "disability_rating", "country", "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/disability?conditions=PTSD,tinnitus&country=UK",
    "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/tdiu?disability_ratings=70&employment_status=unable+to+work&country=Australia",
    "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/state-benefits?state=Ontario&country=Canada",
    "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/home-loan?purchase_price=350000&country=Australia",
    "GET /api/vet/healthcare?disability_rating=70&dependents=true",
    "GET /api/vet/discounts?category=travel&disability_rating=100",
    "GET /api/vet/discounts?category=travel&country=UK"
  ],
  "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.theaslangroupllc.com/openapi.json",
  "llms_txt": "https://vetpulse.theaslangroupllc.com/llms.txt",
  "disclaimer": "Not an official determination from any national veterans-affairs authority. For informational purposes only. Consult the relevant country's accredited claims assistance (e.g. US: VA-accredited VSO, claims agent, or attorney; UK: Veterans UK, RBL, SSAFA; Canada: VAC or a Veterans Service Officer; Australia: DVA or an ESO welfare officer; New Zealand: Veterans' Affairs NZ or RSA; Germany: Sozialverband) for filing assistance."
}
