# SAMHSA FindTreatment Facility Locator

> SAMHSA FindTreatment Facility Locator is a paid API for AI agents from api.healthtravel-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Returns up to 20 SAMHSA-listed substance use and mental health treatment facilities nearest to a given latitude/longitude, with name, address, phone, website, distance, and facility type.

## Facts

- Endpoint: GET https://api.healthtravel-api.workers.dev/api/health/mental-health-samhsa?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/samhsa-findtreatment-facility-locator-9fc56d8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pjgaDpS0An1N_ZW2eBkeC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability samhsa-findtreatment-facility-locator-9fc56d8d
```

Example prompt: Find me SAMHSA-listed substance use and mental health treatment facilities within 10 miles of latitude 34.0522, longitude -118.2437 — show me up to 15 results.

## When to prefer this

Use this endpoint when you need authoritative SAMHSA-sourced treatment facility data by geographic coordinates and do not need ZIP code or city-name search. Ideal for applications where the user's geolocation (lat/lng) is already known and you need structured, ready-to-display facility details including distance. Prefer this over general web searches when you need consistent, structured data from a government-backed source.

## Known failure modes

- Missing lat or lng parameters returns an error
- Coordinates outside valid range (-90 to 90 lat, -180 to 180 lng) return an error
- No facilities found within the specified radius returns an empty list
- Invalid max or radiusMiles values (out of range) may return an error or be clamped to defaults
- Service unavailability or upstream FindTreatment.gov outage returns a 5xx error

## How this service works

SAMHSA FindTreatment substance use and mental health treatment facilities near a latitude and longitude (FindTreatment.gov locator export): facility name, address, phone, website, miles from the point and facility type. Give lat and lng; ZIP or city search is not offered. Up to 20 facilities per call.

## Output

A list of up to 20 treatment facilities from SAMHSA's FindTreatment.gov database, each including facility name, street address, phone number, website URL, distance in miles from the query point, and facility type (e.g. outpatient, residential, detox).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lng"
     ],
     "properties": {
      "lat": {
       "type": "string",
       "description": "Latitude, -90 to 90"
      },
      "lng": {
       "type": "string",
       "description": "Longitude, -180 to 180"
      },
      "max": {
       "type": "string",
       "description": "How many facilities, 1 to 20 (default 5)"
      },
      "radiusMiles": {
       "type": "string",
       "description": "Search radius in miles, 1 to 100 (default 25)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/samhsa-findtreatment-facility-locator-9fc56d8d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthtravel-api.workers.dev](https://www.zero.xyz/host/api.healthtravel-api.workers.dev/llms.txt)