Documentation

REST API - Feeds

Last updated October 2, 2026

Feeds

The REST API feeds endpoint provides a fast and flexible way to browse source feeds registered in the Transitland platform.

Request overview

The feeds API provides a number of searching and filtering parameters; results are based on this GraphQL query.

GEThttps://transit.land/api/v2/rest/feeds

GEThttps://transit.land/api/v2/rest/feeds.{format}Request feeds in specified format
GEThttps://transit.land/api/v2/rest/feeds/{feed_key}Request a feed by ID or Onestop ID
GEThttps://transit.land/api/v2/rest/feeds/{feed_key}.{format}Request a feed by ID or Onestop ID in specified format

Request

feed_keyoptional string: Feed lookup key; can be a Onestop ID or an internal database integer ID
specoptional string: Type of data contained in this feed
Allowed:gtfs, gtfs-rt, gbfs, mds
fetch_erroroptional string: Search for feeds with or without a fetch error
Allowed:true, false
tag_keyoptional string: Search for feeds with a tag. Combine with tag_value also query for the value of the tag.
tag_valueoptional string: Search for feeds tagged with a given value. Must be combined with tag_key.
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
searchoptional string: Full text search
onestop_idoptional string: Search for a specific Onestop ID
lonoptional number: Longitude
latoptional number: Latitude
radiusoptional number: Search for feeds geographically; radius is in meters, requires lon and lat
bboxoptional string: Geographic search using a bounding box, with coordinates in (min_lon, min_lat, max_lon, max_lat) order as a comma separated string
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

feedsarray of Feed

List or search for Feeds (metadata about data sources)

feeds.idinteger

Internal integer ID

feeds.specnullable string (FeedSpecTypes)

Type of feed: GTFS, GTFS_RT, GBFS, or MDS

Allowed:GTFS, GTFS_RT, GBFS, MDS

feeds.namenullable string

A common name for this feed; alternatively use associated_operators[].name

feeds.onestop_idstring

Onestop ID for this feed. Format: f-geohash-name. Example: f-9q9-bart.

feeds.languagesnullable array of strings

Language(s) included in this feed (BCP 47 tags)

feeds.tagsnullable Tags

Atlas tags providing additional metadata for this feed

feeds.urlsnullable FeedUrls

URLs associated with this feed

feeds.licensenullable FeedLicense

Feed license metadata

feeds.authorizationnullable FeedAuthorization

Authorization metadata for fetching data from this feed (e.g., API keys, headers)

feeds.feed_statenullable FeedState

Current state of this feed (e.g. the active feed version)

feeds.feed_versionsarray of FeedVersion

Versions of this feed that have been fetched, archived, and imported

curl "https://transit.land/api/v2/rest/feeds?spec=gtfs" \
  -H "apikey: YOUR_API_KEY"

Example responseShowing 2 of 20 feeds

{
  "feeds": [
    {
      "authorization": {
        "info_url": "",
        "param_name": "",
        "type": ""
      },
      "feed_state": {
        "feed_version": null
      },
      "feed_versions": [
        {
          "earliest_calendar_date": "2026-01-31",
          "fetched_at": "2026-08-29T11:30:01.426468Z",
          "id": 715849,
          "latest_calendar_date": "2027-01-31",
          "sha1": "e43a9f587d7a17677f19b6f848021014d2f36bbc",
          "url": "https://data.trilliumtransit.com/gtfs/caltrain-ca-us/caltrain-ca-us.zip"
        },
        {
          "earliest_calendar_date": "2026-01-31",
          "fetched_at": "2026-06-10T23:22:37.887044Z",
          "id": 685125,
          "latest_calendar_date": "2027-01-31",
          "sha1": "c995688a4fd4e9cd780cfda218c02665395dfceb",
          "url": "https://data.trilliumtransit.com/gtfs/caltrain-ca-us/caltrain-ca-us.zip"
        }
      ],
      "id": 1,
      "languages": null,
      "license": {
        "attribution_instructions": "",
        "attribution_text": "",
        "commercial_use_allowed": "yes",
        "create_derived_product": "yes",
        "redistribution_allowed": "",
        "share_alike_optional": "yes",
        "spdx_identifier": "",
        "url": "http://www.caltrain.com/developer.html",
        "use_without_attribution": "yes"
      },
      "name": null,
      "onestop_id": "f-9q9-caltrain",
      "spec": "GTFS",
      "tags": {
        "calitp_dataset_id": "rec3zcMEdqinLDQtY",
        "exclude_from_global_query": "true",
        "gtfs_data_exchange": "caltrain"
      },
      "urls": {
        "gbfs_auto_discovery": "",
        "mds_provider": "",
        "realtime_alerts": "",
        "realtime_trip_updates": "",
        "realtime_vehicle_positions": "",
        "static_current": "https://data.trilliumtransit.com/gtfs/caltrain-ca-us/caltrain-ca-us.zip",
        "static_historic": [
          "http://www.caltrain.com/Assets/GTFS/caltrain/CT-GTFS.zip"
        ],
        "static_planned": []
      }
    },
    {
      "authorization": {
        "info_url": "",
        "param_name": "",
        "type": ""
      },
      "feed_state": {
        "feed_version": null
      },
      "feed_versions": [
        {
          "earliest_calendar_date": "2026-08-10",
          "fetched_at": "2026-08-05T10:22:58.067934Z",
          "id": 706051,
          "latest_calendar_date": "2027-01-10",
          "sha1": "7cee6b02e4d98a33b34bc3079f5ea4c414cf82ec",
          "url": "http://www.bart.gov/dev/schedules/google_transit.zip"
        },
        {
          "earliest_calendar_date": "2026-08-10",
          "fetched_at": "2026-07-29T10:17:28.019663Z",
          "id": 703528,
          "latest_calendar_date": "2027-01-10",
          "sha1": "add11d546d5ea4b712669e82c6a87ed3af0723c1",
          "url": "http://www.bart.gov/dev/schedules/google_transit.zip"
        }
      ],
      "id": 2,
      "languages": null,
      "license": {
        "attribution_instructions": "",
        "attribution_text": "",
        "commercial_use_allowed": "",
        "create_derived_product": "unknown",
        "redistribution_allowed": "",
        "share_alike_optional": "",
        "spdx_identifier": "",
        "url": "http://www.bart.gov/schedules/developers/developer-license-agreement",
        "use_without_attribution": "yes"
      },
      "name": null,
      "onestop_id": "f-9q9-bart",
      "spec": "GTFS",
      "tags": {
        "calitp_dataset_id": "recQq3GpyffbkrgT2",
        "exclude_from_global_query": "true",
        "gtfs_data_exchange": "airbart",
        "manual_import": "true",
        "notes": "This individual agency feed is fetched and archived but not imported. Agency is imported from f-sf~bay~area~rg"
      },
      "urls": {
        "gbfs_auto_discovery": "",
        "mds_provider": "",
        "realtime_alerts": "",
        "realtime_trip_updates": "",
        "realtime_vehicle_positions": "",
        "static_current": "http://www.bart.gov/dev/schedules/google_transit.zip",
        "static_historic": [],
        "static_planned": []
      }
    }
  ],
  "meta": {
    "after": 25,
    "next": "https://transit.land/api/v2/rest/feeds?after=25&spec=gtfs"
  }
}

Downloading latest static GTFS

GEThttps://transit.land/api/v2/rest/feeds/{feed_key}/download_latest_feed_version

Download the latest feed version GTFS zip for this feed, if redistribution is allowed by the source feed's license

Request

feed_keystringrequired: Feed lookup key; can be an integer ID or Onestop ID value

Response

Returns a file: application/octet-stream

Downloading latest GTFS Realtime

For more information about GTFS Realtime message types and fields, see the GTFS Realtime reference documentation.

GEThttps://transit.land/api/v2/rest/feeds/{feed_key}/download_latest_rt/{rt_type}.{format}

Download the latest snapshot of the specified GTFS Realtime feed, if redistribution is allowed by the source feed's license. Returns 404 if feed or message not found, 401 if redistribution not allowed.

Request

feed_keystringrequired: Feed lookup key; can be an integer ID or Onestop ID value
rt_typestringrequired: GTFS Realtime message types to download
Allowed:alerts, trip_updates, vehicle_positions
formatstringrequired: Output format (JSON, Protocol Buffers, or GeoJSON for vehicle positions)
Allowed:json, pb, geojson, geojsonl

Response

Returns a file: application/octet-stream