# SuVerse Freight Truck Route Planner

> SuVerse Freight Truck Route Planner is a paid API for AI agents from api.suverse.io, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-14).

Calculates truck-optimized routes with toll costs, points of interest, truck stops, and weigh stations based on vehicle specs and cargo constraints

## Facts

- Endpoint: POST https://api.suverse.io/v1/freight/truck_route
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-freight-truck-route-planner-51a2c3de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7_2NQ4cRRMlghavJbDK_0

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 suverse-freight-truck-route-planner-51a2c3de -d '<json body>'
```

Example prompt: Plan a truck route from coordinates 41.8781° N, 87.6298° W (Chicago) to 2693 Main St, Dallas TX for a 6-axle semi weighing 78,000 lbs and 13.5 ft tall carrying hazmat cargo — include truck stops and weigh stations along the way.

## When to prefer this

Use this endpoint when you need commercial vehicle-specific routing that accounts for truck weight, height, axle count, and hazmat status — not just general driving directions. It is ideal when toll cost estimation, truck stop discovery, and weigh station awareness are needed for freight logistics and fleet dispatch workflows. Prefer this over generic routing APIs when payload and vehicle constraints matter legally or operationally.

## Known failure modes

- Invalid or unreachable origin/destination coordinates returns routing error
- Truck weight or height exceeds route maximum restrictions with no viable alternative
- Missing required origin or destination fields returns validation error
- Hazmat routing unavailable for certain corridors or tunnel routes
- Via points that are not reachable by commercial vehicles cause route failure
- API returns HTTP 402 if payment is not attached or insufficient

## How this service works

SuVerse Freight — truck routing with tolls & POIs (freight.truck_route)

## Output

Returns a truck-optimized route between origin and destination accounting for vehicle dimensions and weight constraints, including toll locations and estimated costs, relevant POIs, optional truck stop locations, and optional weigh station positions along the route.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "truck": {
   "type": "object",
   "properties": {
    "axles": {
     "type": "number"
    },
    "hazmat": {
     "type": "boolean"
    },
    "height_ft": {
     "type": "number"
    },
    "weight_lbs": {
     "type": "number"
    }
   }
  },
  "origin": {
   "type": "object",
   "properties": {
    "lat": {
     "type": "number"
    },
    "lon": {
     "type": "number"
    }
   }
  },
  "via_points": {
   "type": "array",
   "items": {}
  },
  "destination": {
   "type": "object",
   "properties": {
    "address": {
     "type": "string"
    }
   }
  },
  "include_truck_stops": {
   "type": "boolean"
  },
  "include_weigh_stations": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-freight-truck-route-planner-51a2c3de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.suverse.io](https://www.zero.xyz/host/api.suverse.io/llms.txt)