GTFS Media API

GET / gtfs module

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.

{
  "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 gtfs module

List available feeds

Every feed loaded into the deployment, with its alias.

Also takes _format.

{
  "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} gtfs module

Describe one feed

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

Also takes feed_alias, _format.

GET /feeds/{feed_alias}/agencies gtfs module

List agencies

Contents of agency.txt.

Also takes feed_alias, limit, offset, _format.

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

Get one agency

Also takes feed_alias, _format.

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

List routes

Contents of routes.txt for one agency.

Also takes feed_alias, limit, offset, _format.

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

Get one route

Also takes feed_alias, _format.

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

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.

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

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.

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

Get one direction of a route

Also takes feed_alias, _format.

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

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.

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

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.

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

Get one trip

Also takes feed_alias, _format.

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

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.

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

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.

{
  "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 gtfs module

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.

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

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.

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

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.

GET /feeds/{feed_alias}/stops gtfs module

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.

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

Get one stop

Also takes feed_alias, _format.

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

List the routes calling at a stop

Also takes feed_alias, limit, offset, _format.

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

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 gtfs module

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.

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

List the stops a trip calls at

Stops on this trip, in stop_sequence order.

Also takes feed_alias, limit, offset, _format.

GET /feeds/{feed_alias}/shapes gtfs module

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.

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

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.

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

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.

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

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.

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

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.

GET /rt/tripupdates/{stop_id} gtfs_rt module

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.

{
  "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} gtfs_rt module

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.

{
  "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} gtfs_rt module

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.

{
  "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ío 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} gtfs_display module

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.

{
  "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
    }
  ]
}

Envelope

The wrapper every successful response shares. data is an object for single resources and an array for collections.

Meta

Counts, paging state and related links.

Links

Related resources. Absent keys mean the relation does not apply. next and previous are false rather than null when there is no further page — test truthiness, not presence.

Error

Error document returned for 4xx and 5xx responses.

ResourceDescriptor

One resource advertised by the API root.

Feed

An imported GTFS feed.

Agency

A row of agency.txt.

Route

A row of routes.txt. Deployments may enrich route payloads with their own fields through hook_gtfs_route_data_alter() — an agency logo URL, a route map image. Treat unrecognised keys as additive rather than an error.

Stop

A row of stops.txt.

Trip

A row of trips.txt.

StopTime

A row of stop_times.txt.

Direction

A direction a route operates in.

Service

A service calendar: which days it runs, over what date range, and the dates that deviate.

ShapeStub

Item shape returned by the shapes collection — an identifier and a link to its points, not the geometry itself.

ShapePoint

One point of a shape, from shapes.txt.

Schedule

A timetable for one route, service and direction, pre-assembled as a grid: schedule.stops are the rows and schedule.trips the columns. Each trip's stop_times array is positionally aligned to schedule.stops and always the same length: index n is that trip's call at stops[n], or null where the trip skips it. Render the grid by walking the two in step — do not match on stop_id.

ScheduleTrip

ScheduleCell

One call in a timetable grid.

GeoJsonFeature

A GeoJSON Feature (RFC 7946). Coordinates are [longitude, latitude] and are real numbers, unlike the string coordinates on static resources. Geometry and properties depend on which resource produced it: a route returns a MultiLineString covering every shape its trips use, with route identity and styling in properties; a trip returns the…

TripUpdate

A GTFS-Realtime TripUpdate. Field names follow the Protobuf schema in camelCase.

RtTripDescriptor

GTFS-Realtime TripDescriptor — which scheduled trip an update refers to. Shared by trip updates and vehicle positions.

RtVehicleDescriptor

GTFS-Realtime VehicleDescriptor — which vehicle is running the trip.

StopTimeEvent

A predicted arrival or departure.

VehiclePosition

A GTFS-Realtime VehiclePosition.

Alert

A GTFS-Realtime Alert. Text fields are TranslatedStrings; pick the translation matching your locale.

TranslatedString

GTFS-Realtime translated text.

Annotation

An operator note or override attached to a GTFS entity.