Service-Area API

"Do you come out to X?" Every home-services business answers this a dozen times a day, and every business defines it differently: a radius, a maximum drive time, a zip list, or "everywhere except downtown." This API evaluates an address against that vendor's actual policy and returns an explainable verdict — true, false, or null (unknown: take the lead, let the owner confirm). It never guesses.

Bring your policy in the request — no stored state

curl -s https://api.composedchaos.net/stl-api/v1/service-area/evaluate \
  -H "X-API-Key: $KEY" -H 'Content-Type: application/json' \
  -d '{"policy": {"home_base": {"lat": 39.0997, "lon": -94.5786},
                  "radius_miles": 35,
                  "exclude_zips": ["64030"]},
       "address": "9 Oak St, Grandview MO 64030"}'

{"in_area": false, "reason": "zip 64030 is excluded",
 "distance_miles": null, "drive_minutes": null}

Rules that match how vendors actually think

• exclude_zips / exclude_cities — always decline (checked first, no geocoding needed)
• include_zips / include_cities — always accept
• max_drive_minutes — real road-network drive time from a home base
• radius_miles — straight-line fallback

{"policy": {"max_drive_minutes": 45,
            "home_base": {"lat": 39.0997, "lon": -94.5786}},
 "lat": 38.98, "lon": -94.67}

{"in_area": true, "reason": "25 min drive (max 45)",
 "distance_miles": 9.6, "drive_minutes": 25.0}

Full reference: api.composedchaos.net/docs