API reference

GET/

List every resource the deployment serves

Returns each REST resource with its URI template. Useful for discovering the surface of an unfamiliar deployment.

Also takes _format.

Returns array of ResourceDescriptor inside the standard envelope.

{
  "meta": {
    "totalCount": 24,
    "dataCount": 24,
    "limit": 0,
    "offset": 0
  },
  "data": [
    {
      "id": "gtfs_stop_resource",
      "label": "GTFS stop REST",
      "uri_template": "https://transit.example.gov/gtfs/api/v2/feeds/{feed_alias}/stops/{stop_id}"
    }
  ]
}

GET/feeds

List available feeds

Every feed loaded into the deployment, with its alias.

Also takes _format.

Returns array of Feed inside the standard envelope.

{
  "meta": {
    "totalCount": 2,
    "dataCount": 2,
    "links": {
      "self": "https://transit.example.gov/gtfs/api/v2/feeds",
      "next": false,
      "previous": false
    },
    "limit": 0,
    "offset": 0
  },
  "data": [
    {
      "name": "Autumn 2026 service change",
      "alias": "autumn-2026",
      "link": "https://transit.example.gov/gtfs/api/v2/feeds/autumn-2026"
    }
  ]
}

GET/feeds/{feed_alias}

Describe one feed

Feed metadata, plus links to its collections in meta.links.

Also takes feed_alias, _format.

Returns Feed inside the standard envelope.

GET/feeds/{feed_alias}/agencies

List agencies

Contents of agency.txt.

Also takes feed_alias, limit, offset, _format.

Returns array of Agency inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}

Get one agency

Also takes feed_alias, _format.

Returns Agency inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes

List routes

Contents of routes.txt for one agency.

Also takes feed_alias, limit, offset, _format.

Returns array of Route inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}

Get one route

Also takes feed_alias, _format.

Returns Route inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/geojson

Get a route's shape as GeoJSON

A GeoJSON Feature whose geometry is a MultiLineString covering every shape the route's trips reference. Route identity and styling (route_color, route_text_color) travel in properties, ready to hand to a map library.

Also takes feed_alias, _format.

Returns GeoJsonFeature inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/directions

List a route's directions

The directions the route operates in, derived from its trips. Direction names come from the feed where present.

Also takes feed_alias, _format.

Returns array of Direction inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/directions/{direction_id}

Get one direction of a route

Also takes feed_alias, _format.

Returns Direction inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/stops/{direction_ids}

List the stops a route serves

Stops along the route, in service order, for one or more directions.

Also takes feed_alias, limit, offset, _format.

Returns array of Stop inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/trips

List a route's trips

Contents of trips.txt for this route. Large routes run to thousands of trips; page with limit and offset.

Also takes feed_alias, limit, offset, _format.

Returns array of Trip inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/trips/{trip_id}

Get one trip

Also takes feed_alias, _format.

Returns Trip inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/trips/{trip_id}/stop_times

List a trip's stop times

Contents of stop_times.txt for the trip, in stop_sequence order. Times may exceed 24 hours ("25:10:00") for service running past midnight, per the GTFS specification.

Also takes feed_alias, limit, offset, _format.

Returns array of StopTime inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/schedules/{service_id}/{direction_id}

Get a route timetable

A timetable for one route, service and direction: the ordered stops and the trips that call at them, assembled ready to render as a grid.

Also takes feed_alias, _format.

Returns Schedule inside the standard envelope.

{
  "meta": {
    "totalCount": 0,
    "dataCount": 0,
    "limit": 500,
    "offset": 0
  },
  "data": {
    "agency_id": "SFMTA",
    "route_id": "1",
    "service_id": "2",
    "direction_id": "0",
    "schedule": {
      "stops": [
        {
          "label": "Clay St & Drumm St (4015)",
          "stop_id": "4015",
          "stop_name": "Clay St & Drumm St"
        },
        {
          "label": "Sacramento St & Kearny St (3892)",
          "stop_id": "3892",
          "stop_name": "Sacramento St & Kearny St"
        }
      ],
      "trips": [
        {
          "label": "Geary + 33rd Avenue",
          "trip_id": "12053368",
          "route_id": "1",
          "service_id": "2",
          "direction_id": "0",
          "stop_times": [
            null,
            {
              "stop_id": 3892,
              "arrival_time": "4:38am",
              "arrival_time_seconds": 16680
            }
          ]
        }
      ]
    }
  }
}

GET/feeds/{feed_alias}/services

List service calendars

Service calendars from calendar.txt. Each item carries the weekly pattern and date range; fetch a single service to add its exceptions from calendar_dates.txt.

Also takes feed_alias, limit, offset, _format.

Returns array of Service inside the standard envelope.

GET/feeds/{feed_alias}/services/{service_id}

Get one service calendar

The weekly service pattern, the date range it applies over, and any exceptions from calendar_dates.txt.

Also takes feed_alias, _format.

Returns Service inside the standard envelope.

GET/feeds/{feed_alias}/shapes/{shape_id}

Get a shape's points

The ordered points of one shape from shapes.txt. For route geometry ready to draw, prefer the route GeoJSON resource.

Also takes feed_alias, limit, offset, _format.

Returns array of ShapePoint inside the standard envelope.

GET/feeds/{feed_alias}/stops

List stops

Contents of stops.txt. Systems commonly have thousands of stops and the default page is 500; follow meta.links.next to page through.

Also takes feed_alias, limit, offset, _format.

Returns array of Stop inside the standard envelope.

GET/feeds/{feed_alias}/stops/{stop_id}

Get one stop

Also takes feed_alias, _format.

Returns Stop inside the standard envelope.

GET/feeds/{feed_alias}/stops/{stop_id}/routes

List the routes calling at a stop

Also takes feed_alias, limit, offset, _format.

Returns array of Route inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/wkt

Get a route's shape as WKT

The same geometry as the GeoJSON resource, as a Well-Known Text MULTILINESTRING. Useful for loading straight into PostGIS or another geospatial tool. The payload is a bare string, not an object.

Also takes feed_alias, _format.

{
  "meta": {
    "totalCount": 0,
    "dataCount": 0,
    "limit": 500,
    "offset": 0
  },
  "data": "MULTILINESTRING((-122.397 37.7954,-122.3968 37.7955))"
}

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/trips/{trip_id}/geojson

Get a trip's shape as GeoJSON

A GeoJSON Feature for one trip's path — a LineString, where the route resource returns a MultiLineString covering every variant. properties carries the trip's identity and headsign.

Also takes feed_alias, _format.

Returns GeoJsonFeature inside the standard envelope.

GET/feeds/{feed_alias}/agencies/{agency_id}/routes/{route_id}/trips/{trip_id}/stops

List the stops a trip calls at

Stops on this trip, in stop_sequence order.

Also takes feed_alias, limit, offset, _format.

Returns array of Stop inside the standard envelope.

GET/feeds/{feed_alias}/shapes

List shape ids

Every shape_id in the feed, with a link to its points. Identifiers only — fetch a shape for its geometry.

Also takes feed_alias, limit, offset, _format.

Returns array of ShapeStub inside the standard envelope.

GET/feeds/{feed_alias}/shapes/{shape_id}/geojson

Get a shape as GeoJSON

A GeoJSON Feature whose geometry is the shape's LineString. Carries no properties; the shape id is in the request.

Also takes feed_alias, _format.

Returns GeoJsonFeature inside the standard envelope.

GET/feeds/{feed_alias}/stops/{stop_id}/directions

List the route directions serving a stop

Every route-and-direction combination that calls at this stop. Each item embeds the full route, so a departure board can be built from one request.

Also takes feed_alias, limit, offset, _format.

Returns array of Direction inside the standard envelope.

GET/feeds/{feed_alias}/stops/{stop_id}/trips

List the trips calling at a stop

Every trip that stops here. Busy stops run to thousands of trips across all service days; page with limit and offset.

Also takes feed_alias, limit, offset, _format.

Returns array of Trip inside the standard envelope.

GET/feeds/{feed_alias}/stops/{stop_id}/stop_times

List scheduled calls at a stop

Every scheduled arrival and departure at this stop, across all trips and service days — the timetable for one stop. Filter by service day using the service_id on the referenced trips.

Also takes feed_alias, limit, offset, _format.

Returns array of StopTime inside the standard envelope.

GET/rt/tripupdates/{stop_id}

Predicted arrivals and departures at a stop

GTFS-Realtime TripUpdate entities affecting this stop, decoded from Protobuf.

Realtime feeds may identify stops differently from the static feed — many agencies publish stop_code in realtime and stop_id in the schedule. Use the identifier your realtime feed uses.

meta.last_fetched is the Unix timestamp of the last successful poll of the upstream feed. Compare it against your own clock to decide whether a prediction is still trustworthy.

Also takes _format.

Returns array of TripUpdate inside the standard envelope.

{
  "meta": {
    "totalCount": 16,
    "dataCount": 16,
    "limit": 500,
    "offset": 0,
    "last_fetched": 1787101680
  },
  "data": [
    {
      "trip": {
        "tripId": "12066664_M21",
        "routeId": "25",
        "directionId": 0,
        "startDate": "20260818",
        "scheduleRelationship": "SCHEDULED",
        "tripHeadsign": "Treasure Island"
      },
      "vehicle": {
        "id": "8744",
        "label": "8744",
        "licensePlate": ""
      },
      "stopTimeUpdate": [
        {
          "stopSequence": 1,
          "stopId": "17948",
          "departure": {
            "delay": 0,
            "time": "1787101800"
          }
        },
        {
          "stopSequence": 2,
          "stopId": "18000",
          "arrival": {
            "delay": 117,
            "time": "1787102517"
          }
        }
      ],
      "timestamp": "1787101656"
    }
  ]
}

GET/rt/vehicles/{route_id}

Live vehicle positions on a route

GTFS-Realtime VehiclePosition entities for the route, with coordinates, bearing and speed where the agency publishes them.

Also takes _format.

Returns array of VehiclePosition inside the standard envelope.

{
  "meta": {
    "totalCount": 12,
    "dataCount": 12,
    "limit": 500,
    "offset": 0,
    "last_fetched": 1787102550
  },
  "data": [
    {
      "trip": {
        "tripId": "12053257_M21",
        "routeId": "1",
        "directionId": 1,
        "startDate": "20260818",
        "scheduleRelationship": "SCHEDULED"
      },
      "vehicle": {
        "id": "5737",
        "label": "5737",
        "licensePlate": ""
      },
      "position": {
        "latitude": 37.795387,
        "longitude": -122.39716,
        "bearing": 75,
        "speed": 0
      },
      "currentStopSequence": 48,
      "stopId": "14015",
      "currentStatus": "STOPPED_AT",
      "timestamp": "1787102547",
      "occupancyStatus": "EMPTY"
    }
  ]
}

GET/rt/alerts/{entity_type}/{entity_id}

Service alerts affecting an entity

GTFS-Realtime Alert entities whose informed entities include the one addressed. Returns an empty array when nothing is disrupted.

Also takes _format.

Returns array of Alert inside the standard envelope.

{
  "meta": {
    "totalCount": 1,
    "dataCount": 1,
    "limit": 500,
    "offset": 0,
    "last_fetched": 1787101680
  },
  "data": [
    {
      "id": "alert_4471",
      "headerText": {
        "translation": [
          {
            "text": "Route 17: weekend detour",
            "language": "en"
          },
          {
            "text": "Ruta 17: desv\u00edo de fin de semana",
            "language": "es"
          }
        ]
      },
      "descriptionText": {
        "translation": [
          {
            "text": "Stops 4030-4034 are closed. Board at Elm St.",
            "language": "en"
          }
        ]
      },
      "informedEntity": [
        {
          "agencyId": "SFMTA",
          "routeId": "17",
          "stopId": null
        }
      ]
    }
  ]
}

GET/display/annotations/{entity_type}/{entity_id}

Operator annotations for an entity

Notes and overrides staff have attached to a GTFS entity — a boarding change, a temporary closure, a message for one route at one stop.

Only annotations currently within their active time window are returned. body is text-format processed HTML.

Also takes _format.

Returns array of Annotation inside the standard envelope.

{
  "meta": {
    "totalCount": 1,
    "dataCount": 1,
    "limit": 500,
    "offset": 0
  },
  "data": [
    {
      "id": 12,
      "annotation_type": "override",
      "entity_type": "stop",
      "entity_id": "4021",
      "secondary_entity_type": "route",
      "secondary_entity_id": "17",
      "body": "<p>Board across the street this weekend.</p>",
      "override_entity_id": "4099",
      "active": true
    }
  ]
}