Modemix API

POST https://api.modemix.io/route
x-api-key: mmx_your_key_here
Content-Type: application/json

Billed per request, pay as you go. Usage is summed monthly across all API keys linked to your account.

Tiered like tax brackets: each request is billed at the rate of the band it falls into. 200,000 requests in a month cost 100,000 × $5.00/1k + 100,000 × $4.00/1k = $900.00.

Every request needs an API key in the x-api-key header.

curl -X POST https://api.modemix.io/route \
  -H "x-api-key: mmx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Calculate optimal bike + transit routes between two points.

Request

{
  "origin": { "latitude": 37.7749, "longitude": -122.4194 },
  "destination": { "latitude": 37.8044, "longitude": -122.2712 },
  "leave_after": 1700000000,
  "arrive_by": null,
  "bike_speed_mps": 5.0,
  "walk_speed_mps": 1.4,
  "region_id": "bay_area"
}

Response

{
  "routes": [
    [
      { "mode": "bike", "duration_seconds": 180, "distance_meters": 900, ... },
      { "mode": "platform_access", "duration_seconds": 120, ... },
      { "mode": "train", "route_id": "...", "train_info": { ... }, ... },
      { "mode": "platform_access", "duration_seconds": 60, ... },
      { "mode": "bike", "duration_seconds": 240, "distance_meters": 1200, ... }
    ]
  ],
  "total_routes": 3,
  "shortest_route_index": 0
}

Each route is an array of segments. Segment modes are bike, train, platform_access, and walk. Every segment includes start, end, start_time, end_time, and duration_seconds.

API keys may have a per-client request rate limit. Past it, the API returns 429 Too Many Requests. Back off and retry after a short delay.

No route found returns 200 with an empty routes array.