OpenAPI Specification
openapi: 3.0.3
info:
title: MBTA V3 Alerts RoutePatterns API
description: The MBTA V3 API provides fast, easy access to Massachusetts Bay Transportation Authority schedules, alerts, and real-time information. Returns JSON:API formatted responses (application/vnd.api+json) for routes, stops, trips, schedules, predictions, vehicles, alerts, lines, facilities, services, shapes, and route patterns. Free API keys are available via the developer portal for higher rate limits.
version: '3.0'
contact:
name: MBTA Developers
url: https://www.mbta.com/developers
termsOfService: https://www.mass.gov/files/documents/2017/10/27/massdot-developers-license-agreement.pdf
servers:
- url: https://api-v3.mbta.com
description: Production
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: RoutePatterns
description: Possible travel patterns within a route
paths:
/route_patterns:
get:
operationId: listRoutePatterns
summary: List route patterns
tags:
- RoutePatterns
parameters:
- $ref: '#/components/parameters/PageOffset'
- $ref: '#/components/parameters/PageLimit'
- $ref: '#/components/parameters/Sort'
- $ref: '#/components/parameters/Include'
responses:
'200':
$ref: '#/components/responses/JsonApiOk'
/route_patterns/{id}:
get:
operationId: getRoutePattern
summary: Get route pattern
tags:
- RoutePatterns
parameters:
- $ref: '#/components/parameters/IdPath'
- $ref: '#/components/parameters/Include'
responses:
'200':
$ref: '#/components/responses/JsonApiOk'
'404':
$ref: '#/components/responses/NotFound'
components:
parameters:
Sort:
name: sort
in: query
description: Comma-separated list of fields to sort by. Prepend '-' for descending.
schema:
type: string
PageOffset:
name: page[offset]
in: query
description: Offset (0-based) into the collection.
schema:
type: integer
minimum: 0
Include:
name: include
in: query
description: Comma-separated list of relationships to include.
schema:
type: string
IdPath:
name: id
in: path
required: true
schema:
type: string
PageLimit:
name: page[limit]
in: query
description: Maximum number of resources to return.
schema:
type: integer
minimum: 1
responses:
NotFound:
description: Resource not found.
JsonApiOk:
description: Successful JSON:API response.
content:
application/vnd.api+json:
schema:
type: object
properties:
data: {}
included:
type: array
items: {}
links:
type: object
meta:
type: object
securitySchemes:
apiKeyHeader:
type: apiKey
in: header
name: x-api-key
apiKeyQuery:
type: apiKey
in: query
name: api_key
externalDocs:
description: MBTA V3 API Documentation
url: https://www.mbta.com/developers/v3-api