# VetPulse

> Veterans benefits intelligence API. Surfaces VA disability compensation, Aid & Attendance, TDIU, GI Bill, VA home loans, state benefits, caregiver stipends, and discounts most veterans never claim. Pay-per-query via x402 micropayments on Base.

## What This Is

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

Coverage: US VA benefits only (by design). For UK veterans: see Veterans UK at gov.uk/government/organisations/veterans-uk. For Canadian veterans: Veterans Affairs Canada at veterans.gc.ca. For Australian veterans: DVA at dva.gov.au.

## Payment

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

## Endpoints

GET /api/vet/disability?conditions={comma-separated}
- Returns: likely VA disability rating per condition, combined rating math, monthly compensation, PACT Act eligibility, secondary conditions to add, nexus letter topics
- Price: $0.15

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

GET /api/vet/tdiu?rating={combined_rating}&work_history={description}
- Returns: TDIU eligibility assessment, schedular vs. extraschedular path, income threshold, application strategy
- Price: $0.15

GET /api/vet/claim-builder?conditions={conditions}&service_era={era}
- Returns: evidence brief — what medical records to gather, buddy statement guidance, C&P exam prep, nexus letter template, secondary conditions to add, claim strategy
- Price: $0.15

GET /api/vet/state-benefits?state={state}
- Returns: property tax exemptions, tuition waivers, hunting/fishing licenses, employment preference, DMV benefits, burial benefits for the specified state
- Price: $0.10

GET /api/vet/education?chapter={chapter}&branch={branch}
- 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
- Price: $0.10

GET /api/vet/home-loan?disability_rating={rating}&purchase_price={price}
- Returns: funding fee exemption, no-PMI savings vs conventional, COE process, entitlement restoration, state-specific first-time buyer programs stacking with VA loan
- Price: $0.10

GET /api/vet/healthcare?priority_group={group}&income={income}
- Returns: priority group placement, copay schedule, CHAMPVA for dependents, community care eligibility, mental health services, dental coverage
- Price: $0.10

GET /api/vet/caregiver?relationship={relationship}&veteran_needs={needs}
- Returns: PCAFC eligibility (Program of Comprehensive Assistance for Family Caregivers), monthly stipend range ($800–$3,300+), CHAMPVA health insurance for caregiver, respite care, application steps
- Price: $0.10

GET /api/vet/discounts?category={travel|retail|dining|recreation}
- Returns: verified veteran discounts by category — airlines, hotels, retail, dining, national parks, recreation, financial services
- Price: $0.05

## Discovery

- OpenAPI spec: https://vetpulse-five.vercel.app/openapi.json
- Agent discovery: https://vetpulse-five.vercel.app/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON
- Disclaimer appended automatically: "Not an official VA determination. Consult an accredited VSO or VA-accredited attorney."
- 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 non-US veterans: direct users to Veterans UK (UK), Veterans Affairs Canada, or DVA Australia