Documentation

REST API - Trips

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 & 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, TUESDAY, NEXT_WEDNESDAY
Allowed:TODAY, 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 for this trip; pass active: true to return only currently active alerts

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 for this route, including those on its mode, at its stops, or on its trips; pass active: true to return only currently active alerts

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 for this agency; pass active: true to return only currently active alerts

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 for this stop; pass active: true to return only currently active alerts

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