MapQuest Directions API

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
servers:
- url: https://www.mapquestapi.com
  description: MapQuest API
tags:
- name: Directions
paths:
  /directions/v2/route:
    get:
      operationId: getRoute
      summary: Calculate a route between locations
      responses:
        '200':
          description: Route result
        default:
          description: Error response
      tags:
      - Directions
    post:
      operationId: postRoute
      summary: Calculate a route between locations
      responses:
        '200':
          description: Route result
        default:
          description: Error response
      tags:
      - Directions
  /directions/v2/optimizedroute:
    get:
      operationId: getOptimizedRoute
      summary: Calculate an optimized route
      responses:
        '200':
          description: Optimized route result
        default:
          description: Error response
      tags:
      - Directions
    post:
      operationId: postOptimizedRoute
      summary: Calculate an optimized route
      responses:
        '200':
          description: Optimized route result
        default:
          description: Error response
      tags:
      - Directions
  /directions/v2/routematrix:
    post:
      operationId: postRouteMatrix
      summary: Calculate a route matrix
      responses:
        '200':
          description: Route matrix result
        default:
          description: Error response
      tags:
      - Directions
  /directions/v2/routematrix/jobs:
    post:
      operationId: createRouteMatrixJob
      summary: Submit an asynchronous route matrix job
      responses:
        '202':
          description: Job submitted
        default:
          description: Error response
      tags:
      - Directions
  /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
      tags:
      - Directions
  /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
      tags:
      - Directions
  /directions/v2/alternateroutes:
    get:
      operationId: getAlternateRoutes
      summary: Calculate alternate routes
      responses:
        '200':
          description: Alternate routes result
        default:
          description: Error response
      tags:
      - Directions
    post:
      operationId: postAlternateRoutes
      summary: Calculate alternate routes
      responses:
        '200':
          description: Alternate routes result
        default:
          description: Error response
      tags:
      - Directions
  /directions/v2/routeshape:
    get:
      operationId: getRouteShape
      summary: Retrieve route shape geometry
      responses:
        '200':
          description: Route shape result
        default:
          description: Error response
      tags:
      - Directions
x-generated-from: https://developer.mapquest.com/documentation/directions-api/
x-generated-by: claude-crawl-2026-05-08