mta.routes.list() — list subway and bus routes

GET

https://www.mtaapi.dev

api

routes

List static routes

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.mtaapi.dev/api/v1/routes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "id": "<string>",
    "shortName": "<string>",
    "longName": "<string>",
    "type": 123,
    "color": "<string>",
    "textColor": "<string>"
  }
]

Returns the catalog of routes in the hosted stops snapshot. Pass a comma-separated modes filter (for example subway,bus) to scope the list, or omit it for every mode. Each entry is a Route plus a mode: { id, shortName?, longName?, color?, textColor?, type?, mode }. Use it to populate a route picker or hydrate route metadata client-side.

SDK

const routes = await mta.routes.list({ modes: ['subway', 'bus'] })

for (const route of routes) {
  console.log(route.shortName ?? route.id, route.mode)
}

See the Routes & Stations guide.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

modes

string

Comma-separated transit modes to include, such as subway,bus.

Response

200 - application/json

Response for status 200

string

required

mode

enum<string>

required

Available options:

subway,

bus

shortName

string

longName

string

type

number

color

string

textColor

string

Stops by IDReference for GET /api/v1/stops. Resolve multiple stop IDs in a single request, preserving request order, optionally with served routes.

List static routes

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.mtaapi.dev/api/v1/routes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "id": "<string>",
    "shortName": "<string>",
    "longName": "<string>",
    "type": 123,
    "color": "<string>",
    "textColor": "<string>"
  }
]

​SDK

Authorizations

Query Parameters

Response

SDK