Skip to main content
This guide shows how to list NYC Ferry routes and stops, and retrieve arrivals from the public GTFS-Realtime feed.

Prerequisites

  • Install mta-js with npm install mta-js.
  • Set MTA_API_KEY in your environment.
  • Requires mta-js 2.4.0 or later.
1

Explore NYC Ferry stops and routes

The static endpoints are built from NYC Ferry’s public GTFS feed:
You can also request the ordered stops for one route:
2

Request live arrivals

Filter realtime trip updates by stop, route, or both:
The optional stop accepts a stop ID or an exact stop name, matched without case sensitivity, such as 87 or Wall St/Pier 11.Arrival records include static stop and route names, trip headsigns, estimated arrival time, and minutes until arrival.
3

Check vehicles and service alerts

Vehicle positions can be filtered by route. Alerts are listed from the separate alert feed:
NYC Ferry static stops and routes are opt-in in the shared /stops, /stops/near, and /routes endpoints. Add nyc-ferry to the modes query parameter; omitted modes continues to return subway and bus only.