Skip to main content

V3 API

About the V3 API

The new V3 API provides fast, easy access to MBTA schedules, alerts, and real-time information.

You can try it out without a key, but we strongly recommend using a key early in the development process. Keys are available for free at api-v3.mbta.com.

Basic Calls

The V3 API data model is based on GTFS and GTFS-realtime where applicable. The following calls are available:

  • alerts
  • facilities - elevators, escalators, and (coming soon) parking lots, bike racks, etc.
  • predictions - predicted arrival/departure times
  • routes
  • schedules - scheduled arrival/departure times (stop_time)
  • shapes - stops and maps for branches, including route variations
  • stops
  • trips
  • vehicles - vehicle positions

Each call returns the object described. Following the JSON API standard, options are provided to filter or sort the list in various ways, and to include other objects with related information.

Filter

The following examples of filtering use the routes call:

Include

An arrival time doesn't mean much unless you know where the vehicle is arriving and where it's going next. Some objects are defined largely by their relationship to other objects. Those other objects can be included in the results as well.

The following examples of "including" use the schedules call:

  • schedules?filter... returns a selection of scheduled stops (`stop_times`), which contains the route_id, trip_id, and stop_id, but no information about the corresponding trip, route, or stop.
  • schedules?include=route&filter... includes each route object referenced by a schedule object, providing the route name, mode, color, etc. The included values are in an `include[]` object and can be looked up from the predictions by their type and id.
  • schedules?include=route,trip,stop&filter... includes the routes as well as the trips and stops.  
  • schedules?include=prediction&filter... includes real-time predictions (if any) currently being made for the returned scheduled times. In this example URL you're only likely to see predictions if you make the call around 1:30 PM-2:30 PM EST.

For more information, see the V3 API Swagger documentation and get a key at api-v3.mbta.com.

Use of MBTA data is governed by the MassDOT Developers License Agreement.