Valhalla

Valhalla is an open-source routing engine and library suite for OpenStreetMap data. It provides turn-by-turn navigation, isochrone computation, time-distance matrix analysis, map matching, elevation sampling, optimized routing (TSP), and graph expansion via a REST API. Valhalla supports multiple travel modes including auto, bicycle, pedestrian, transit, truck, motorcycle, and motor scooter. It uses a tiled hierarchical data structure for efficient offline routing and regional extracts, with dynamic costing via a plugin architecture.

Valhalla publishes 11 APIs on the APIs.io network, including Expansion API, Height API, Isochrone API, and 8 more. Tagged areas include Routing, Navigation, OpenStreetMap, Mapping, and Geospatial.

The Valhalla catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Valhalla’s developer surface includes GitHub presence, documentation, and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub
43.1/100 developing ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFree
11 APIs
RoutingNavigationOpenStreetMapMappingGeospatialDirectionsIsochronesTravelTransportationOpen Source

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 43.1/100 · developing
Contract Quality 16.4 / 25
Developer Ergonomics 1.7 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 4.8 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 28/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/valhalla: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

Valhalla Expansion API

The Expansion API from Valhalla — 1 operation(s) for expansion.

Valhalla Height API

The Height API from Valhalla — 1 operation(s) for height.

Valhalla Isochrone API

The Isochrone API from Valhalla — 1 operation(s) for isochrone.

Valhalla Locate API

The Locate API from Valhalla — 1 operation(s) for locate.

Valhalla Optimized Route API

The Optimized Route API from Valhalla — 1 operation(s) for optimized route.

Valhalla Route API

The Route API from Valhalla — 1 operation(s) for route.

Valhalla Sources To Targets API

The Sources To Targets API from Valhalla — 1 operation(s) for sources to targets.

Valhalla Status API

The Status API from Valhalla — 1 operation(s) for status.

Valhalla Tile API

The Tile API from Valhalla — 1 operation(s) for tile.

Valhalla Trace Attributes API

The Trace Attributes API from Valhalla — 1 operation(s) for trace attributes.

Valhalla Trace Route API

The Trace Route API from Valhalla — 1 operation(s) for trace route.

Scroll for all 11

Pricing Plans 1

Published pricing tiers and plan structures.

Open Source

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Openstreetmap De

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Self Hosted

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Valhalla Context

0 classes · 56 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Valhalla API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 4

Standalone JSON Schema definitions for this provider's data models.

IsochroneRequest

11 properties

JSON SCHEMA

Location

13 properties

JSON SCHEMA

MatrixRequest

10 properties

JSON SCHEMA

RouteRequest

15 properties

JSON SCHEMA

Examples 4

Example request and response payloads for these APIs.

Height

3 fields

EXAMPLE

Isochrone

3 fields

EXAMPLE

Route

3 fields

EXAMPLE

Sources To Targets

3 fields

EXAMPLE

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Valhalla Domain Security

TLSv1.3

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Valhalla Agentic Access

12 operations · 9 acting

12 operations · 9 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

DemoServer
DemoServer

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 OpenAPI
OpenAPI

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHub
GitHub

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

License
License
 Plans
Plans
 FinOps
FinOps

Source (apis.yml)

apis.yml Raw ↑ 
name: Valhalla
description: Valhalla is an open-source routing engine and library suite for OpenStreetMap data. It provides turn-by-turn
  navigation, isochrone computation, time-distance matrix analysis, map matching, elevation sampling, optimized routing (TSP),
  and graph expansion via a REST API. Valhalla supports multiple travel modes including auto, bicycle, pedestrian, transit,
  truck, motorcycle, and motor scooter. It uses a tiled hierarchical data structure for efficient offline routing and regional
  extracts, with dynamic costing via a plugin architecture.
accessModel:
  pricing: free
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Free
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://valhalla.github.io/valhalla/images/valhalla.png
tags:
- Routing
- Navigation
- OpenStreetMap
- Mapping
- Geospatial
- Directions
- Isochrones
- Travel
- Transportation
- Open Source
created: '2026-06-13'
modified: '2026-06-13'
url: https://raw.githubusercontent.com/api-evangelist/valhalla/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: valhalla:valhalla-expansion-api
  name: Valhalla Expansion API
  description: The Expansion API from Valhalla — 1 operation(s) for expansion.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Expansion
  properties:
  - type: OpenAPI
    url: openapi/valhalla-expansion-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-height-api
  name: Valhalla Height API
  description: The Height API from Valhalla — 1 operation(s) for height.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Height
  properties:
  - type: OpenAPI
    url: openapi/valhalla-height-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-isochrone-api
  name: Valhalla Isochrone API
  description: The Isochrone API from Valhalla — 1 operation(s) for isochrone.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Isochrone
  properties:
  - type: OpenAPI
    url: openapi/valhalla-isochrone-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-locate-api
  name: Valhalla Locate API
  description: The Locate API from Valhalla — 1 operation(s) for locate.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Locate
  properties:
  - type: OpenAPI
    url: openapi/valhalla-locate-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-optimized-route-api
  name: Valhalla Optimized Route API
  description: The Optimized Route API from Valhalla — 1 operation(s) for optimized route.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Optimized Route
  properties:
  - type: OpenAPI
    url: openapi/valhalla-optimized-route-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-route-api
  name: Valhalla Route API
  description: The Route API from Valhalla — 1 operation(s) for route.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Route
  properties:
  - type: OpenAPI
    url: openapi/valhalla-route-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-sources-to-targets-api
  name: Valhalla Sources To Targets API
  description: The Sources To Targets API from Valhalla — 1 operation(s) for sources to targets.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Sources To Targets
  properties:
  - type: OpenAPI
    url: openapi/valhalla-sources-to-targets-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-status-api
  name: Valhalla Status API
  description: The Status API from Valhalla — 1 operation(s) for status.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Status
  properties:
  - type: OpenAPI
    url: openapi/valhalla-status-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-tile-api
  name: Valhalla Tile API
  description: The Tile API from Valhalla — 1 operation(s) for tile.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Tile
  properties:
  - type: OpenAPI
    url: openapi/valhalla-tile-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-trace-attributes-api
  name: Valhalla Trace Attributes API
  description: The Trace Attributes API from Valhalla — 1 operation(s) for trace attributes.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Trace Attributes
  properties:
  - type: OpenAPI
    url: openapi/valhalla-trace-attributes-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
- aid: valhalla:valhalla-trace-route-api
  name: Valhalla Trace Route API
  description: The Trace Route API from Valhalla — 1 operation(s) for trace route.
  humanURL: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  baseURL: https://valhalla1.openstreetmap.de
  tags:
  - Trace Route
  properties:
  - type: OpenAPI
    url: openapi/valhalla-trace-route-api-openapi.yml
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/turn-by-turn/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/optimized/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/matrix/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/isochrone/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/map-matching/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/elevation/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/expansion/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/api/locate/api-reference/
  - type: Documentation
    url: https://valhalla.github.io/valhalla/
common:
- type: AgenticAccess
  url: agentic-access/valhalla-agentic-access.yml
- type: DomainSecurity
  url: security/valhalla-domain-security.yml
- type: GitHub
  url: https://github.com/valhalla/valhalla
- type: Documentation
  url: https://valhalla.github.io/valhalla/
- type: OpenAPI
  url: https://valhalla.github.io/valhalla/api/openapi/
- type: DemoServer
  url: https://valhalla.openstreetmap.de/
- type: License
  url: https://github.com/valhalla/valhalla/blob/master/LICENSE.md
- type: RateLimits
  url: https://raw.githubusercontent.com/api-evangelist/valhalla/refs/heads/main/rate-limits/openstreetmap-de.yml
- type: Plans
  url: https://raw.githubusercontent.com/api-evangelist/valhalla/refs/heads/main/plans/open-source.yml
- type: FinOps
  url: https://raw.githubusercontent.com/api-evangelist/valhalla/refs/heads/main/finops/self-hosted.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com