MapQuest Directions API
The MapQuest Directions API provides routing capabilities with turn-by-turn directions, alternate routes, optimized routes, and travel time estimates using real-time traffic data.
OpenAPI Specification
openapi: 3.1.0
info:
title: MapQuest Directions API
description: >-
Minimal OpenAPI 3.1 specification for the MapQuest Directions API,
covering route, optimized route, route matrix, alternate routes,
and route shape endpoints.
version: 2.0.0
x-generated-from: https://developer.mapquest.com/documentation/directions-api/
x-generated-by: claude-crawl-2026-05-08
servers:
- url: https://www.mapquestapi.com
description: MapQuest API
paths:
/directions/v2/route:
get:
operationId: getRoute
summary: Calculate a route between locations
responses:
'200':
description: Route result
default:
description: Error response
post:
operationId: postRoute
summary: Calculate a route between locations
responses:
'200':
description: Route result
default:
description: Error response
/directions/v2/optimizedroute:
get:
operationId: getOptimizedRoute
summary: Calculate an optimized route
responses:
'200':
description: Optimized route result
default:
description: Error response
post:
operationId: postOptimizedRoute
summary: Calculate an optimized route
responses:
'200':
description: Optimized route result
default:
description: Error response
/directions/v2/routematrix:
post:
operationId: postRouteMatrix
summary: Calculate a route matrix
responses:
'200':
description: Route matrix result
default:
description: Error response
/directions/v2/routematrix/jobs:
post:
operationId: createRouteMatrixJob
summary: Submit an asynchronous route matrix job
responses:
'202':
description: Job submitted
default:
description: Error response
/directions/v2/routematrix/jobs/{jobId}:
get:
operationId: getRouteMatrixJob
summary: Retrieve route matrix job status
parameters:
- name: jobId
in: path
required: true
schema:
type: string
responses:
'200':
description: Job status
default:
description: Error response
/directions/v2/routematrix/jobs/{jobId}/results:
get:
operationId: getRouteMatrixJobResults
summary: Retrieve route matrix job results
parameters:
- name: jobId
in: path
required: true
schema:
type: string
responses:
'200':
description: Job results
default:
description: Error response
/directions/v2/alternateroutes:
get:
operationId: getAlternateRoutes
summary: Calculate alternate routes
responses:
'200':
description: Alternate routes result
default:
description: Error response
post:
operationId: postAlternateRoutes
summary: Calculate alternate routes
responses:
'200':
description: Alternate routes result
default:
description: Error response
/directions/v2/routeshape:
get:
operationId: getRouteShape
summary: Retrieve route shape geometry
responses:
'200':
description: Route shape result
default:
description: Error response
components: {}