# Rome2Rio Route Options Lookup

> Rome2Rio Route Options Lookup is a paid API for AI agents from api.healthtravel-api.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Returns headline travel option count, top 4-5 route modes (train, bus, flight, car, ferry, rideshare), labels (Best/Cheapest/Fastest), travel time, and price range in USD with links for a given origin-destination pair via Rome2Rio.

## Facts

- Endpoint: GET https://api.healthtravel-api.workers.dev/api/travel/rome2rio?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rome2rio-route-options-lookup-a0bdb047
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oPeXmLVyJprEaz5Ym0dEM

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 rome2rio-route-options-lookup-a0bdb047
```

Example prompt: What are the best ways to travel from London to Amsterdam — show me the top options including trains, buses, and flights with travel times and approximate costs.

## When to prefer this

Use this endpoint when you need structured multi-modal travel options (train, bus, flight, ferry, rideshare, car) between two named places, including labeled best/cheapest/fastest options with price ranges and times, sourced live from Rome2Rio. Prefer this over flight-only or booking APIs when the user wants to compare all transport modes rather than book a specific ticket, and when city-pair lookup by name (not airport code) is sufficient.

## Known failure modes

- Missing 'from' or 'to' query parameter returns a validation error
- Unrecognized or ambiguous place names may return no results or incorrect routes
- Rome2Rio page rendering may fail if the residential proxy encounters a block or timeout
- Route pages for very obscure or remote locations may have limited or no options
- Price and time data may be outdated or approximate depending on Rome2Rio cache freshness

## How this service works

Rome2Rio ways to travel between two places: the headline count ('11 ways to travel...') and the top options shown first (train, bus, flight, rideshare, car, ferry...) with label (Best, Cheapest, Fastest), total travel time (minutes and text) and price range in USD, plus the link to each route. From rome2rio.com's public route pages via a rendering residential proxy; the page shows the 4-5 top options first.

## Output

Returns the headline count of available travel options (e.g. '11 ways to travel'), the top 4-5 route options with their mode (train, bus, flight, ferry, car, rideshare), a label (Best, Cheapest, or Fastest), total travel time in minutes and human-readable text, a price range in USD, and a direct link to the Rome2Rio route page for each option.

## 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",
       "description": "Destination place, e.g. Paris"
      },
      "from": {
       "type": "string",
       "description": "Origin place, e.g. London, 'New York', 'Barcelona Airport'"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rome2rio-route-options-lookup-a0bdb047/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)
