Documentation

REST API - Trips

Last updated October 6, 2026

Trips

Trips are trips.txt entities imported from GTFS, and include the same basic structure and fields, plus some additional metadata.

Trip responses include their associated shape, calendar, frequency, and stop departure information; these entities do not have stand-alone endpoints.

For an overview of trips, schedules, and service calendars, see the Trips and schedules concept page.

Request overview

Trips must be accessed through a route; either a route ID or Onestop ID may be used.

Stop time information is only available when requesting a single trip by ID.

To instead see all departures from a given stop, use the stops departures endpoint.

Shapes are included when accessing a single trip, requesting geojson or geojsonl formats, or with include_geometry=true.

Trips scheduled to run on a particular date can be selected using the service_date parameter, a date in YYYY-MM-DD format.

The trip API returns "active" feed versions unless requesting a specific feed version.

Trip API results are based on this GraphQL query.

GEThttps://transit.land/api/v2/rest/routes/{route_key}/trips

GEThttps://transit.land/api/v2/rest/routes/{route_key}/trips.{format}Request trips in specified format
GEThttps://transit.land/api/v2/rest/routes/{route_key}/trips/{id}Request a trip by ID
GEThttps://transit.land/api/v2/rest/routes/{route_key}/trips/{id}.{format}Request a trip by ID in specified format

Request

route_keystringrequired: Route lookup key; can be an integer ID, a '<feed onestop_id>:<gtfs route_id>' key, or a Onestop ID
service_dateoptional string (date): Search for trips active on this date
trip_idoptional string: Search for records with this GTFS trip_id
include_geometryoptional string: Include shape geometry
Allowed:true, false
use_service_windowoptional string: Use a fall-back service date if the requested service_date is outside the active service period of the feed version. The fall-back date is selected as the matching day-of-week in the week which provides the best level of scheduled service in the feed version. This value defaults to true.
Allowed:true, false
relative_dateoptional string: Search for departures on a relative date label, e.g. TODAY, TOMORROW, TUESDAY, NEXT_WEDNESDAY
Allowed:TODAY, YESTERDAY, TOMORROW, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY, NEXT_MONDAY, NEXT_TUESDAY, NEXT_WEDNESDAY, NEXT_THURSDAY, NEXT_FRIDAY, NEXT_SATURDAY, NEXT_SUNDAY
include_alertsoptional string: Include alerts from GTFS Realtime feeds
Allowed:true, false
idoptional integer (int32): Search for a specific internal ID
afteroptional integer (int32): Pagination cursor value. This should be treated as an opaque value created by the server and returned as the link to the next result page, which may be empty. For historical reasons, this is based on the integer record ID values, but that should not be assumed to be the case in the future.
limitoptional integer (int32): Maximum number of records to return
formatoptional string: Response format
Allowed:json, geojson, geojsonl
feed_version_sha1optional string: Search for records in this feed version
feed_onestop_idoptional string: Search for records in this feed
latoptional number: Latitude
lonoptional number: Longitude
license_commercial_use_allowedoptional string: Filter entities by feed license 'commercial_use_allowed' value. Please see Source Feed concept for details on license values. 'exclude_no' is equivalent to 'yes' and 'unknown'.
Allowed:yes, no, unknown, exclude_no
license_share_alike_optionaloptional string: Filter entities by feed license 'share_alike_optional' value. Please see Source Feed concept for details on license values. 'exclude_no' is equivalent to 'yes' and 'unknown'.
Allowed:yes, no, unknown, exclude_no
license_create_derived_productoptional string: Filter entities by feed license 'create_derived_product' value. Please see Source Feed concept for details on license values. 'exclude_no' is equivalent to 'yes' and 'unknown'.
Allowed:yes, no, unknown, exclude_no
license_redistribution_allowedoptional string: Filter entities by feed license 'redistribution_allowed' value. Please see Source Feed concept for details on license values. 'exclude_no' is equivalent to 'yes' and 'unknown'.
Allowed:yes, no, unknown, exclude_no
license_use_without_attributionoptional string: Filter entities by feed license 'use_without_attribution' value. Please see Source Feed concept for details on license values. 'exclude_no' is equivalent to 'yes' and 'unknown'.
Allowed:yes, no, unknown, exclude_no

Response

tripsarray of Trip

List or search for Trips

trips.idinteger

Internal integer ID

trips.trip_idstring

GTFS trips.trip_id

trips.trip_headsignnullable string

GTFS trips.trip_headsign; text that appears on signage identifying the trip's destination to riders

trips.trip_short_namenullable string

GTFS trips.trip_short_name; public-facing text used to identify the trip to riders, such as a train number

trips.direction_idnullable integer

GTFS trips.direction_id; binary indicator of travel direction [0=outbound, 1=inbound]; meaning depends on the agency

trips.block_idnullable string

GTFS trips.block_id; trips with the same block_id are operated in sequence by the same vehicle

trips.wheelchair_accessiblenullable integer

GTFS trips.wheelchair_accessible [0=no information, 1=vehicle can accommodate at least one rider in a wheelchair, 2=no riders in wheelchairs can be accommodated]

trips.bikes_allowednullable integer

GTFS trips.bikes_allowed [0=no information, 1=vehicle can accommodate at least one bicycle, 2=no bicycles allowed]

trips.cars_allowednullable integer

GTFS trips.cars_allowed [0=no information, 1=vehicle can accommodate at least one car, 2=no cars allowed]

trips.schedule_relationshipnullable string (ScheduleRelationship)

Real-time status of this trip. STATIC means no GTFS-RT data was matched; otherwise reflects the matching TripUpdate's schedule_relationship. See ScheduleRelationship for per-value semantics

Allowed:SCHEDULED, ADDED, UNSCHEDULED, CANCELED, STATIC, SKIPPED, NO_DATA, REPLACEMENT, DUPLICATED, DELETED

trips.stop_pattern_idinteger

Calculated stop pattern ID; an integer scoped to the feed version

trips.feed_versionFeedVersion

Feed version for this entity

trips.shapenullable Shape

Shape for this trip

trips.calendarCalendar

Calendar for this trip

trips.frequenciesarray of Frequency

Frequencies for this trip

trips.alertsnullable array of Alert

GTFS-RT service alerts on this trip, whose agency, route and mode, if given, are the trip's; pass active: true to return only currently active alerts

trips.alerts.entity_idstring

Id of the GTFS-RT FeedEntity that carried this alert, as published by its realtime feed. This is the realtime message's own entity id, not a GTFS static id like those in informed_entity. It should be unique within one realtime feed but not across feeds, so identify an alert by rt_feed_onestop_id and entity_id together, for example to merge the copies of an alert reached through a stop, its routes and their agency. Producers are not required to keep it the same between fetches

trips.alerts.rt_feed_onestop_idstring

Onestop ID of the feed whose GTFS-RT data this alert came from. A feed may carry both static and realtime URLs, so this can be the same feed as a feed_onestop_id elsewhere in the schema

trips.alerts.causenullable string

GTFS-RT Alert cause

trips.alerts.effectnullable string

GTFS-RT Alert effect

trips.alerts.severity_levelnullable string

Alert severity: UNKNOWN_SEVERITY, INFO, WARNING, or SEVERE

trips.alerts.urlnullable array of RTTranslation

URL for more information

trips.alerts.header_textarray of RTTranslation

GTFS-RT Alert header text

trips.alerts.description_textarray of RTTranslation

GTFS-RT Alert description text

trips.alerts.tts_header_textnullable array of RTTranslation

Header text optimized for text-to-speech (TTS) systems

trips.alerts.tts_description_textnullable array of RTTranslation

Description text optimized for text-to-speech (TTS) systems

trips.alerts.active_periodnullable array of RTTimeRange

Time ranges during which this alert is active. See https://gtfs.org/realtime/reference/#message-timerange

trips.alerts.informed_entitynullable array of RTEntitySelector

Entities this alert applies to, as published. See https://gtfs.org/realtime/reference/#message-entityselector

trips.routeRoute

Route for this trip

trips.route.idinteger

Internal integer ID

trips.route.onestop_idnullable string

Onestop ID for this route

trips.route.route_idstring

GTFS routes.route_id

trips.route.route_short_namenullable string

GTFS routes.route_short_name; short name of a route, such as a line number or abbreviation

trips.route.route_long_namenullable string

GTFS routes.route_long_name; full descriptive name of a route

trips.route.alertsnullable array of Alert

GTFS-RT service alerts on this route, as a whole or at one of its stops, whose agency and mode, if given, are the route's; pass active: true to return only currently active alerts, include_modes: true to also return alerts on the route's mode, such as all of its agency's subway service, and include_trips: true to also return alerts on the route's trips

trips.route.alerts.entity_idstring

trips.route.alerts.rt_feed_onestop_idstring

Onestop ID of the feed whose GTFS-RT data this alert came from. A feed may carry both static and realtime URLs, so this can be the same feed as a feed_onestop_id elsewhere in the schema

trips.route.alerts.causenullable string

GTFS-RT Alert cause

trips.route.alerts.effectnullable string

GTFS-RT Alert effect

trips.route.alerts.severity_levelnullable string

Alert severity: UNKNOWN_SEVERITY, INFO, WARNING, or SEVERE

trips.route.alerts.urlnullable array of RTTranslation

URL for more information

trips.route.alerts.header_textarray of RTTranslation

GTFS-RT Alert header text

trips.route.alerts.description_textarray of RTTranslation

GTFS-RT Alert description text

trips.route.alerts.tts_header_textnullable array of RTTranslation

Header text optimized for text-to-speech (TTS) systems

trips.route.alerts.tts_description_textnullable array of RTTranslation

Description text optimized for text-to-speech (TTS) systems

trips.route.alerts.active_periodnullable array of RTTimeRange

Time ranges during which this alert is active. See https://gtfs.org/realtime/reference/#message-timerange

trips.route.alerts.informed_entitynullable array of RTEntitySelector

Entities this alert applies to, as published. See https://gtfs.org/realtime/reference/#message-entityselector

trips.route.agencyAgency

Agency associated with this route

trips.route.agency.idinteger

Internal integer ID

trips.route.agency.agency_idstring

GTFS agency.agency_id

trips.route.agency.agency_namestring

GTFS agency.agency_name

trips.route.agency.onestop_idstring

Onestop ID for this agency (or its associated operator)

trips.route.agency.alertsnullable array of Alert

GTFS-RT service alerts on this agency as a whole, not those narrowed to a route, stop or trip; pass active: true to return only currently active alerts, and include_modes: true to also return alerts on a mode the agency runs, such as all of its subway service

trips.route.agency.alerts.entity_idstring

trips.route.agency.alerts.rt_feed_onestop_idstring

Onestop ID of the feed whose GTFS-RT data this alert came from. A feed may carry both static and realtime URLs, so this can be the same feed as a feed_onestop_id elsewhere in the schema

trips.route.agency.alerts.causenullable string

GTFS-RT Alert cause

trips.route.agency.alerts.effectnullable string

GTFS-RT Alert effect

trips.route.agency.alerts.severity_levelnullable string

Alert severity: UNKNOWN_SEVERITY, INFO, WARNING, or SEVERE

trips.route.agency.alerts.urlnullable array of RTTranslation

URL for more information

trips.route.agency.alerts.header_textarray of RTTranslation

GTFS-RT Alert header text

trips.route.agency.alerts.description_textarray of RTTranslation

GTFS-RT Alert description text

trips.route.agency.alerts.tts_header_textnullable array of RTTranslation

Header text optimized for text-to-speech (TTS) systems

trips.route.agency.alerts.tts_description_textnullable array of RTTranslation

Description text optimized for text-to-speech (TTS) systems

trips.route.agency.alerts.active_periodnullable array of RTTimeRange

Time ranges during which this alert is active. See https://gtfs.org/realtime/reference/#message-timerange

trips.route.agency.alerts.informed_entitynullable array of RTEntitySelector

Entities this alert applies to, as published. See https://gtfs.org/realtime/reference/#message-entityselector

trips.stop_timesarray of StopTime

Stop times for this trip

trips.stop_times.arrival_timenullable string (hms)

GTFS stop_times.arrival_time

Example:15:21:04

trips.stop_times.departure_timenullable string (hms)

GTFS stop_times.departure_time

Example:15:21:04

trips.stop_times.stop_sequenceinteger

GTFS stop_times.stop_sequence; order of stops for this trip; values must increase along the trip but need not be consecutive

trips.stop_times.stop_headsignnullable string

GTFS stop_times.stop_headsign; overrides the trip-level headsign for passengers boarding at this stop

trips.stop_times.pickup_typenullable integer

GTFS stop_times.pickup_type [0=regular scheduled pickup, 1=no pickup available, 2=must phone agency to arrange, 3=must coordinate with driver]

trips.stop_times.drop_off_typenullable integer

GTFS stop_times.drop_off_type [0=regular scheduled drop-off, 1=no drop-off available, 2=must phone agency to arrange, 3=must coordinate with driver]

trips.stop_times.timepointnullable integer

GTFS stop_times.timepoint [0=times are approximate, 1=times are exact]

trips.stop_times.interpolatednullable integer

1 if this arrival/departure time was filled in by interpolation during import; 0 or null otherwise

trips.stop_times.stopStop

Stop associated with this stop time

trips.stop_times.stop.idinteger

Internal integer ID

trips.stop_times.stop.stop_idstring

GTFS stops.stop_id

Example:400029

trips.stop_times.stop.stop_namenullable string

GTFS stops.stop_name

Example:MADISON AV/E 68 ST

trips.stop_times.stop.geometryPoint

Geographic location of this stop as a GeoJSON Point

trips.stop_times.stop.alertsnullable array of Alert

GTFS-RT service alerts on this stop, with or without a route. An agency, route or mode the alert also gives must be in this stop's feed version and agree with each other; alerts on a trip at the stop are on the trip instead. Pass active: true to return only currently active alerts

trips.stop_times.stop.alerts.entity_idstring

trips.stop_times.stop.alerts.rt_feed_onestop_idstring

Onestop ID of the feed whose GTFS-RT data this alert came from. A feed may carry both static and realtime URLs, so this can be the same feed as a feed_onestop_id elsewhere in the schema

trips.stop_times.stop.alerts.causenullable string

GTFS-RT Alert cause

trips.stop_times.stop.alerts.effectnullable string

GTFS-RT Alert effect

trips.stop_times.stop.alerts.severity_levelnullable string

Alert severity: UNKNOWN_SEVERITY, INFO, WARNING, or SEVERE

trips.stop_times.stop.alerts.urlnullable array of RTTranslation

URL for more information

trips.stop_times.stop.alerts.header_textarray of RTTranslation

GTFS-RT Alert header text

trips.stop_times.stop.alerts.description_textarray of RTTranslation

GTFS-RT Alert description text

trips.stop_times.stop.alerts.tts_header_textnullable array of RTTranslation

Header text optimized for text-to-speech (TTS) systems

trips.stop_times.stop.alerts.tts_description_textnullable array of RTTranslation

Description text optimized for text-to-speech (TTS) systems

trips.stop_times.stop.alerts.active_periodnullable array of RTTimeRange

Time ranges during which this alert is active. See https://gtfs.org/realtime/reference/#message-timerange

trips.stop_times.stop.alerts.informed_entitynullable array of RTEntitySelector

Entities this alert applies to, as published. See https://gtfs.org/realtime/reference/#message-entityselector

curl "https://transit.land/api/v2/rest/routes/r-dr5r7-statenislandferry/trips?trip_id=weekendstgeorge000000" \
  -H "apikey: YOUR_API_KEY"

Example response

{
  "trips": [
    {
      "bikes_allowed": 1,
      "block_id": null,
      "calendar": {
        "added_dates": [],
        "end_date": "2028-01-30",
        "friday": 0,
        "monday": 0,
        "removed_dates": [],
        "saturday": 1,
        "service_id": "weekend",
        "start_date": "2026-01-03",
        "sunday": 1,
        "thursday": 0,
        "tuesday": 0,
        "wednesday": 0
      },
      "cars_allowed": null,
      "direction_id": 0,
      "feed_version": {
        "feed": {
          "id": 13,
          "onestop_id": "f-dr5r7-nycdotsiferry"
        },
        "fetched_at": "2026-01-16T02:46:14.015508Z",
        "sha1": "34d6bc485d02631cce789ae8a8c27d8e6551fd43"
      },
      "frequencies": [],
      "id": 9505148953,
      "schedule_relationship": "STATIC",
      "shape": {
        "generated": false,
        "shape_id": "stgeorge"
      },
      "stop_pattern_id": 0,
      "trip_headsign": null,
      "trip_id": "weekendstgeorge000000",
      "trip_short_name": null,
      "wheelchair_accessible": 1
    }
  ]
}