# VetPulse

> Global veterans benefits intelligence API. Surfaces disability compensation, Aid & Attendance-style pensions, TDIU/unemployability, education benefits, home-buying assistance, state/regional benefits, caregiver stipends, and discounts most veterans never claim — across the US (VA), UK, Canada, Australia, New Zealand, and Germany. Pay-per-query via x402 micropayments on Base.

## What This Is

VetPulse is a pay-per-query API that helps veterans and their families worldwide navigate their national benefits system. Millions of veterans are underrated, missing benefits, or unaware of entitlements. VetPulse surfaces the gaps.

Coverage: pass `?country=` on any endpoint to get an AI-synthesized assessment for that nation's system — US (VA), UK (Veterans UK, Armed Forces Compensation Scheme, War Pension Scheme), Canada (Veterans Affairs Canada), Australia (Department of Veterans' Affairs), New Zealand (Veterans' Affairs NZ), or Germany (Bundeswehr Versorgung) — with best-effort support for any other country. Every endpoint also considers veterans living abroad relative to the country paying their benefit. Omit `country` and it's inferred where possible (e.g. from a recognized region name) or defaults to a US-anchored answer with a note asking you to specify a country for precise guidance elsewhere.

Note: the US GI Bill and VA Home Loan Guaranty are unusually generous by international standards and have no exact 1:1 foreign equivalent — the `education` and `home-loan` endpoints name the closest real program in each country and are direct when no dedicated veteran-specific program exists (e.g. Canada/New Zealand/Germany home-buying).

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

All endpoints accept an optional `country` param (US, UK, Canada, Australia, New Zealand, Germany, or best-effort for any other nation).

GET /api/vet/disability?conditions={comma-separated}&country={country}
- Returns: likely disability rating per condition, combined rating math, monthly compensation, presumptive/toxic-exposure eligibility (e.g. PACT Act for US), secondary conditions to add, nexus/causation letter topics
- Price: $0.15

GET /api/vet/aid-attendance?age={age}&needs={description}&country={country}
- Returns: Aid & Attendance-style pension eligibility (up to $2,727/month in the US, or the local equivalent), asset limits, income requirements, application steps, accredited advocate referral
- Price: $0.10

GET /api/vet/tdiu?rating={combined_rating}&work_history={description}&country={country}
- Returns: TDIU/unemployability eligibility assessment (US schedular/extraschedular, Australia's TPI, Canada's DEC/IRB, UK's AFCS GIP), income threshold, application strategy
- Price: $0.15

GET /api/vet/claim-builder?conditions={conditions}&service_era={era}&country={country}
- Returns: evidence brief — what records to gather, buddy/witness statement guidance, exam prep, nexus/causation letter template, secondary conditions to add, claim strategy adapted to the country's actual process
- Price: $0.15

GET /api/vet/state-benefits?state={state}&country={country}
- Returns: property tax exemptions, tuition waivers, hunting/fishing licenses, employment preference, DMV benefits, burial benefits for the specified US state — or the equivalent sub-national programs for UK devolved nations, Canadian provinces, Australian states/territories, NZ/German regions
- Price: $0.10

GET /api/vet/education?chapter={chapter}&branch={branch}&country={country}
- Returns: GI Bill benefit comparison (Ch. 33 vs 30 vs 35 vs 1606), monthly housing allowance, tuition coverage, STEM scholarship, Vocational Rehabilitation (Ch. 31) eligibility for the US — or the closest real program (UK ELC/SLC, Canada's VAC ETB, Australia's DVA schemes, NZ/Germany equivalents) elsewhere
- Price: $0.10

GET /api/vet/home-loan?disability_rating={rating}&purchase_price={price}&country={country}
- Returns: funding fee exemption, no-PMI savings vs conventional, COE process, entitlement restoration, state-specific first-time buyer programs stacking with the VA loan (US) — or Australia's DHOAS subsidy / UK's Forces Help to Buy; honest guidance where no veteran-specific home-loan program exists (Canada, NZ, Germany)
- Price: $0.10

GET /api/vet/healthcare?priority_group={group}&income={income}&country={country}
- Returns: priority group placement, copay schedule, dependent coverage (CHAMPVA for US), community/civilian care eligibility, mental health services, dental coverage — or the equivalent under UK NHS priority care, Canada's VAC benefits, Australia's Gold/White Card, NZ/Germany entitlements
- Price: $0.10

GET /api/vet/caregiver?relationship={relationship}&veteran_needs={needs}&country={country}
- Returns: family caregiver stipend eligibility (US PCAFC $800–$3,300+/month plus CHAMPVA, Canada's VAC Caregiver Recognition Benefit, Australia's DVA Carer Allowance/Payment, UK/NZ/Germany support), respite care, application steps
- Price: $0.10

GET /api/vet/discounts?category={travel|retail|dining|recreation}&country={country}
- Returns: verified veteran discounts by category — US (airlines, hotels, retail, dining, national parks, financial services), UK (Defence Discount Service, Blue Light Card), Australia (RSL), New Zealand (RSA)
- Price: $0.05

## Discovery

- OpenAPI spec: https://vetpulse.theaslangroupllc.com/openapi.json
- Agent discovery: https://vetpulse.theaslangroupllc.com/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON, including a `country_scope` field noting which country was assessed and whether it was assumed as a fallback
- Disclaimer appended automatically: "Not an official determination from any national veterans-affairs authority. Consult the relevant country's accredited claims assistance."
- WealthPulse is a natural sibling for retirement planning alongside VA benefits
- SeniorPulse is a natural sibling for aging veterans navigating Medicare + VA healthcare coordination
- For veterans living abroad relative to the country paying their benefit: most endpoints surface a cross-border note directly — no separate signposting needed
- The US GI Bill and VA Home Loan Guaranty are unusually generous by international standards; non-US responses from `education` and `home-loan` are direct about scope rather than implying equivalent terms elsewhere