Valhalla · Example Payload

Route

Example /route request for a car trip from Washington DC to Philadelphia via auto costing.

RoutingNavigationOpenStreetMapMappingGeospatialDirectionsIsochronesTravelTransportationOpen-Source

Route is an example object payload from Valhalla, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

descriptionrequestresponse_summary

Example Payload

{
  "description": "Example /route request for a car trip from Washington DC to Philadelphia via auto costing.",
  "request": {
    "locations": [
      { "lat": 38.8977, "lon": -77.0366, "name": "White House, Washington DC" },
      { "lat": 39.9526, "lon": -75.1652, "name": "City Hall, Philadelphia" }
    ],
    "costing": "auto",
    "costing_options": {
      "auto": {
        "use_highways": 0.8,
        "use_tolls": 0.5
      }
    },
    "units": "miles",
    "language": "en-US",
    "directions_type": "instructions",
    "alternates": 1
  },
  "response_summary": {
    "trip": {
      "summary": {
        "length": 141.2,
        "time": 8520
      },
      "legs": [
        {
          "summary": {
            "length": 141.2,
            "time": 8520
          },
          "shape": "encoded_polyline_here",
          "maneuvers": [
            {
              "type": 1,
              "instruction": "Drive northeast on Pennsylvania Avenue Northwest.",
              "street_names": ["Pennsylvania Avenue Northwest"],
              "time": 60,
              "length": 0.4
            }
          ]
        }
      ],
      "status": 0,
      "status_message": "Found route between points",
      "units": "miles",
      "language": "en-US"
    }
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/route"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.