# Citiview Routing & Directions API

> Citiview Routing & Directions API is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Returns turn-by-turn driving, cycling, walking, truck, or transit directions between two or more places, with distance, travel time, and optional GeoJSON route geometry.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/route?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-routing-directions-api-93b7e62f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uNDVIyYrTFS32oU_ijgaV

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 citiview-routing-directions-api-93b7e62f
```

Example prompt: Can you get me driving directions from Chicago, IL to Milwaukee, WI avoiding tolls, and show me the distance in miles with turn-by-turn steps?

## When to prefer this

Choose this endpoint when you need turn-by-turn directions, route distance, or travel time between named places or coordinates, especially when travel mode (drive, truck, bike, walk, transit) or avoidance options (tolls, highways, ferries) matter. It is preferred over geocoding-only endpoints when routing and navigation logic is required, and over general mapping APIs when you need a structured step-by-step itinerary with distance in both metric and imperial units.

## Known failure modes

- Unresolvable origin or destination address returns an error or empty result
- Invalid travel mode value causes a bad request response
- Unreachable route (e.g. island with no ferry without ferry option) may return no route found
- Malformed coordinates or address strings may produce geocoding errors
- Network timeout for very long or complex multi-stop routes

## How this service works

Directions between places (addresses, names or lat,lon) with optional stops: distance in km and miles, travel time, and turn-by-turn steps for driving, trucks, cycling, walking or transit, avoiding tolls, highways or ferries; optional GeoJSON route line.

## Output

Returns the total distance in both kilometers and miles, estimated travel time, and a sequential list of turn-by-turn navigation steps. If geometry is requested, also includes a GeoJSON LineString representing the route path. Intermediate waypoints are supported via the 'via' parameter.

## 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": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string"
      },
      "via": {
       "type": "string",
       "description": "Stops separated by |"
      },
      "from": {
       "type": "string"
      },
      "mode": {
       "type": "string",
       "description": "drive (default), truck, bicycle, walk, transit, ..."
      },
      "avoid": {
       "type": "string",
       "description": "tolls|highways|ferries"
      },
      "units": {
       "type": "string",
       "description": "metric or imperial"
      },
      "geometry": {
       "type": "boolean",
       "description": "true to include the route line"
      }
     }
    }
   },
   "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/citiview-routing-directions-api-93b7e62f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)