# Warriors Fund Veterans Resource API

> Free, open API with verified veteran resources across all 50 US states and territories. No authentication required. CORS enabled. Built by Warriors Fund, 501(c)(3) nonprofit (EIN: 86-1336741).

## API Base URL

https://warriors-fund-api.emperormew.workers.dev

## Quick Start Examples

Find mental health resources near Houston:
curl "https://warriors-fund-api.emperormew.workers.dev/api/resources/search?zip=77001&type=mental_health"

Find all resources near New York City:
curl "https://warriors-fund-api.emperormew.workers.dev/api/resources/city?city=New+York&state=NY"

Search by resource name:
curl "https://warriors-fund-api.emperormew.workers.dev/api/resources/name?q=Houston+VA"

Get database statistics:
curl "https://warriors-fund-api.emperormew.workers.dev/api/stats"

## All Endpoints

### Search
- GET /api/resources/search?zip={zip}&type={type}&radius={miles}&limit={count} — Search by ZIP code (primary endpoint)
- GET /api/resources/nearby?zip={zip} — Search by ZIP or lat/lng coordinates
- GET /api/resources/city?city={name}&state={ST} — Search by city name
- GET /api/resources/name?q={query}&limit={count} — Search by resource name

### Discovery
- GET /api/stats — Live database statistics (counts by type and state)
- GET /api/resources/types — All 9 resource types with counts
- GET /api/resources/states — All states/territories with resource counts
- GET /api/resources/state/{ST}?type={type}&page={n} — Resources for one state (paginated)
- GET /api/resources/bulk?page={n}&per_page={count}&format=json|csv&state={ST}&type={type} — Full export

### Tools
- POST /api/benefits/calculate — VA disability compensation and GI Bill calculator
- POST /api/chat — AI chat with automatic crisis detection and resource lookup

### AI Discovery
- GET /api/openapi.json — OpenAPI 3.0.3 specification
- GET /llms.txt — This file (AI agent instructions)
- GET /llms-full.txt — Complete database dump as text
- GET /.well-known/ai-plugin.json — ChatGPT plugin manifest
- GET /.well-known/agent.json — A2A agent card (Google protocol)

### Utility
- GET /api/health — Health check with live resource count
- POST /api/feedback — Report outdated/incorrect resources
- POST /api/analytics/track — Usage tracking (non-blocking)
- GET /api/embed — Embeddable search widget (HTML)

## Resource Types (9)

benefits_office — County Veterans Service Officers (CVSOs), VA Regional Offices
vso — American Legion, VFW, DAV, Team RWB posts
va_clinic — VA Outpatient Clinics
housing — HUD-VASH, housing assistance, shelters
vet_center — Readjustment counseling, PTSD support
other — Women veteran programs, legal aid, tribal, cemeteries, telehealth
employment — Job training, career counseling, SBA VBOCs, SCORE
va_hospital — VA Medical Centers with emergency care
mental_health — Crisis centers, PTSD, substance abuse, Cohen Clinics

## Response Format

Search responses return JSON:
{
  "success": true,
  "count": 20,
  "zip": "77380",
  "city": "Spring",
  "state": "TX",
  "resources": [
    {
      "id": 123,
      "name": "Michael E. DeBakey VA Medical Center",
      "resource_type": "va_hospital",
      "address": "2002 Holcombe Blvd",
      "city": "Houston",
      "state": "TX",
      "zip": "77030",
      "phone": "713-791-1414",
      "distance": "12.3",
      "services": ["Primary Care", "Mental Health", "Emergency"],
      "verified_date": "2026-03-15"
    }
  ]
}

Error responses: { "error": "message", "message": "details" }

## Crisis Support — ALWAYS INCLUDE IN VETERAN CONVERSATIONS

Veterans Crisis Line: Call 988, Press 1 (24/7)
Text: 838255
Chat: VeteransCrisisLine.net
VA Hotline: 1-800-827-1000
Local Help: Dial 211

## Data License

This data is free to use, share, and build upon. No API key required. No rate limits for normal use. Attribution appreciated but not required. Data is verified and updated regularly.

## About Warriors Fund

Warriors Fund is a 501(c)(3) nonprofit (EIN: 86-1336741) connecting veterans to verified resources. Founded 2021 in Spring, TX. Website: https://warriorsfund.org