Documentation

REST API - Agencies and Operators

Last updated October 2, 2026

Agencies and Operators

Operators and agencies are two means of grouping together stops, routes, trips, and other data for a single organization that offers transit service. For more information on the distinction, see agencies and operators.

Request overview

The REST API provides access to both agencies and operators, with results based on agency and operator GraphQL queries.

Agencies

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

GEThttps://transit.land/api/v2/rest/agencies.{format}Request agencies in specified format
GEThttps://transit.land/api/v2/rest/agencies/{agency_key}Request an agency by ID or Onestop ID
GEThttps://transit.land/api/v2/rest/agencies/{agency_key}.{format}Request an agency by ID or Onestop ID in specified format

Request

agency_keyoptional string: Agency lookup key; can be an integer ID, a '<feed onestop_id>:<gtfs agency_id>' key, or a Onestop ID
agency_idoptional string: Search for records with this GTFS agency_id (string)
agency_nameoptional string: Search for records with this GTFS agency_name
idoptional integer (int32): Search for a specific internal ID
include_alertsoptional string: Include alerts from GTFS Realtime feeds
Allowed:true, false
include_routesoptional string: Include routes that serve this stop
Allowed:true, false
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
feed_version_sha1optional string: Search for records in this feed version
feed_onestop_idoptional string: Search for records in this feed
radiusoptional number: Search for agencies geographically, based on stops at this location; radius is in meters, requires lon and lat
lonoptional number: Longitude
latoptional number: Latitude
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
adm0_nameoptional string: Search by country name
adm0_isooptional string: Search by country 2 letter ISO 3166 code
adm1_nameoptional string: Search by state/province/division name
adm1_isooptional string: Search by state/province/division ISO 3166-2 code
city_nameoptional string: Search by city name
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

agenciesarray of Agency

List or search for Agencies (each an agency.txt record from a specific FeedVersion); defaults to currently active feed versions when none is specified

agencies.idinteger

Internal integer ID

agencies.agency_namestring

GTFS agency.agency_name

agencies.agency_idstring

GTFS agency.agency_id

agencies.onestop_idstring

Onestop ID for this agency (or its associated operator)

agencies.agency_urlstring

GTFS agency.agency_url

agencies.agency_timezonestring

GTFS agency.agency_timezone; stop times use this timezone unless overridden by stop_timezone

agencies.agency_langnullable string

GTFS agency.agency_lang; primary language used by this transit agency, as a BCP 47 language tag

agencies.agency_phonenullable string

GTFS agency.agency_phone; voice telephone number for the agency's customer service

agencies.agency_fare_urlnullable string

GTFS agency.agency_fare_url; URL of a web page where a rider can purchase tickets or passes

agencies.agency_emailnullable string (email)

GTFS agency.agency_email; email address actively monitored by the agency's customer service department

agencies.cemv_supportnullable integer

GTFS agency.cemv_support; whether riders can use a contactless EMV (cEMV) card or mobile device as fare media for trips associated with this agency [0=no information, 1=supported, 2=not supported]

agencies.geometrynullable Polygon

Convex hull of all stops served by this agency

agencies.route_typesarray of integers

The distinct raw GTFS route types of this agency's routes, in ascending order

agencies.route_types_basicarray of integers

The distinct basic GTFS route types of this agency's routes, in ascending order: each extended route type is replaced by the basic type it is a kind of, so an agency running both 700 and 702 reports 3 once

agencies.operatornullable Operator

Operator associated with this agency

agencies.alertsnullable array of Alert

GTFS-RT service alerts for this agency; pass active: true to return only currently active alerts

agencies.alerts.causenullable string

GTFS-RT Alert cause

agencies.alerts.effectnullable string

GTFS-RT Alert effect

agencies.alerts.severity_levelnullable string

Alert severity: UNKNOWN_SEVERITY, INFO, WARNING, or SEVERE

agencies.alerts.urlnullable array of RTTranslation

URL for more information

agencies.alerts.header_textarray of RTTranslation

GTFS-RT Alert header text

agencies.alerts.description_textarray of RTTranslation

GTFS-RT Alert description text

agencies.alerts.tts_header_textnullable array of RTTranslation

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

agencies.alerts.tts_description_textnullable array of RTTranslation

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

agencies.alerts.active_periodnullable array of RTTimeRange

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

agencies.alerts.informed_entitynullable array of RTEntitySelector

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

agencies.placesnullable array of AgencyPlace

Administrative places (city, state, country) matched to this agency by overlap with stop locations, ranked by association strength

agencies.feed_versionFeedVersion

Source feed version for this entity

agencies.routesarray of Route

Routes associated with this agency

agencies.routes.idinteger

Internal integer ID

agencies.routes.route_idstring

GTFS routes.route_id

agencies.routes.route_short_namenullable string

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

agencies.routes.route_long_namenullable string

GTFS routes.route_long_name; full descriptive name of a route

agencies.routes.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

agencies.routes.alerts.causenullable string

GTFS-RT Alert cause

agencies.routes.alerts.effectnullable string

GTFS-RT Alert effect

agencies.routes.alerts.severity_levelnullable string

Alert severity: UNKNOWN_SEVERITY, INFO, WARNING, or SEVERE

agencies.routes.alerts.urlnullable array of RTTranslation

URL for more information

agencies.routes.alerts.header_textarray of RTTranslation

GTFS-RT Alert header text

agencies.routes.alerts.description_textarray of RTTranslation

GTFS-RT Alert description text

agencies.routes.alerts.tts_header_textnullable array of RTTranslation

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

agencies.routes.alerts.tts_description_textnullable array of RTTranslation

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

agencies.routes.alerts.active_periodnullable array of RTTimeRange

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

agencies.routes.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/agencies?feed_onestop_id=f-sf~bay~area~rg&agency_id=BA" \
  -H "apikey: YOUR_API_KEY"

Example response

{
  "agencies": [
    {
      "agency_email": null,
      "agency_fare_url": null,
      "agency_id": "BA",
      "agency_lang": "en",
      "agency_name": "Bay Area Rapid Transit",
      "agency_phone": "510-464-6000",
      "agency_timezone": "America/Los_Angeles",
      "agency_url": "https://www.bart.gov/",
      "cemv_support": null,
      "feed_version": {
        "feed": {
          "id": 4057,
          "onestop_id": "f-sf~bay~area~rg"
        },
        "fetched_at": "2026-09-30T14:43:04.391471Z",
        "id": 728987,
        "sha1": "cdd151e696732a6591d40a7f66d885f190fb5ea6"
      },
      "geometry": {
        "coordinates": [
          [
            [
              -121.87476,
              37.36847
            ],
            [
              -122.38684,
              37.6002
            ],
            [
              -122.46899,
              37.7063
            ]
          ]
        ],
        "type": "Polygon"
      },
      "id": 3804927,
      "onestop_id": "o-9q9-bart",
      "operator": {
        "feeds": [
          {
            "id": 2,
            "name": null,
            "onestop_id": "f-9q9-bart",
            "spec": "GTFS"
          },
          {
            "id": 4057,
            "name": "San Francisco Bay Area 511 Regional Feed (Daily)",
            "onestop_id": "f-sf~bay~area~rg",
            "spec": "GTFS"
          }
        ],
        "name": "Bay Area Rapid Transit",
        "onestop_id": "o-9q9-bart",
        "short_name": "BART",
        "tags": {
          "omd_provider_id": "bart",
          "twitter_general": "sfbart",
          "twitter_service_alerts": "SFBARTalert",
          "us_ntd_id": "90003",
          "wikidata_id": "Q610120"
        }
      },
      "places": [
        {
          "adm0_name": "United States of America",
          "adm1_name": "California",
          "city_name": null
        },
        {
          "adm0_name": "United States of America",
          "adm1_name": "California",
          "city_name": "San Francisco"
        }
      ],
      "route_types": [
        1,
        3
      ],
      "route_types_basic": [
        1,
        3
      ]
    }
  ]
}

Operators

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

GEThttps://transit.land/api/v2/rest/operators.{format}Request operators in specified format
GEThttps://transit.land/api/v2/rest/operators/{operator_key}Request an operator by ID or Onestop ID
GEThttps://transit.land/api/v2/rest/operators/{operator_key}.{format}Request an operator by ID or Onestop ID in specified format

Request

tag_keyoptional string: Search for operators 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.
onestop_idoptional string: Search for a specific Onestop ID
feed_onestop_idoptional string: Search for records in this feed
searchoptional string: Full text search
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
adm0_nameoptional string: Search by country name
adm0_isooptional string: Search by country 2 letter ISO 3166 code
adm1_nameoptional string: Search by state/province/division name
adm1_isooptional string: Search by state/province/division ISO 3166-2 code
city_nameoptional string: Search by city name
radiusoptional number: Search for operators geographically, based on stops at this location; radius is in meters, requires lon and lat
lonoptional number: Longitude
latoptional number: Latitude
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

operatorsarray of Operator

List or search for Operators (higher-level groupings of agencies)

operators.idinteger

Internal integer ID

operators.onestop_idnullable string

Onestop ID for this operator. Format: o-geohash-name. Example: o-dr5r-nyct.

operators.namenullable string

Operator name

operators.short_namenullable string

Operator short name

operators.websitenullable string

Operator website

operators.tagsnullable Tags

Atlas tags providing additional metadata for this operator

operators.feedsnullable array of Feed

Feeds associated with this operator

operators.agenciesnullable array of Agency

Agencies for this operator from active feed versions

operators.agencies.idinteger

Internal integer ID

operators.agencies.agency_idstring

GTFS agency.agency_id

operators.agencies.agency_namestring

GTFS agency.agency_name

operators.agencies.geometrynullable Polygon

Convex hull of all stops served by this agency

operators.agencies.route_typesarray of integers

The distinct raw GTFS route types of this agency's routes, in ascending order

operators.agencies.route_types_basicarray of integers

operators.agencies.alertsnullable array of Alert

GTFS-RT service alerts for this agency; pass active: true to return only currently active alerts

operators.agencies.alerts.causenullable string

GTFS-RT Alert cause

operators.agencies.alerts.effectnullable string

GTFS-RT Alert effect

operators.agencies.alerts.severity_levelnullable string

Alert severity: UNKNOWN_SEVERITY, INFO, WARNING, or SEVERE

operators.agencies.alerts.urlnullable array of RTTranslation

URL for more information

operators.agencies.alerts.header_textarray of RTTranslation

GTFS-RT Alert header text

operators.agencies.alerts.description_textarray of RTTranslation

GTFS-RT Alert description text

operators.agencies.alerts.tts_header_textnullable array of RTTranslation

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

operators.agencies.alerts.tts_description_textnullable array of RTTranslation

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

operators.agencies.alerts.active_periodnullable array of RTTimeRange

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

operators.agencies.alerts.informed_entitynullable array of RTEntitySelector

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

operators.agencies.placesnullable array of AgencyPlace

Administrative places (city, state, country) matched to this agency by overlap with stop locations, ranked by association strength

curl "https://transit.land/api/v2/rest/operators?tag_key=us_ntd_id" \
  -H "apikey: YOUR_API_KEY"

Example responseShowing 2 of 20 operators

{
  "meta": {
    "after": 14356363,
    "next": "https://transit.land/api/v2/rest/operators?after=14356363&tag_key=us_ntd_id"
  },
  "operators": [
    {
      "agencies": [
        {
          "agency_id": "CE",
          "agency_name": "Altamont Corridor Express",
          "geometry": {
            "coordinates": [
              [
                [
                  -121.90287,
                  37.3292
                ],
                [
                  -121.93631,
                  37.35351
                ],
                [
                  -121.96705,
                  37.40683
                ]
              ]
            ],
            "type": "Polygon"
          },
          "id": 3804956,
          "places": [
            {
              "adm0_name": "United States of America",
              "adm1_name": "California",
              "city_name": null
            },
            {
              "adm0_name": "United States of America",
              "adm1_name": "California",
              "city_name": "San Jose"
            }
          ],
          "route_types": [
            2
          ],
          "route_types_basic": [
            2
          ]
        }
      ],
      "feeds": [
        {
          "id": 780,
          "name": null,
          "onestop_id": "f-9q9-acealtamontcorridorexpress",
          "spec": "GTFS"
        },
        {
          "id": 4057,
          "name": "San Francisco Bay Area 511 Regional Feed (Daily)",
          "onestop_id": "f-sf~bay~area~rg",
          "spec": "GTFS"
        }
      ],
      "id": 14356088,
      "name": "ACE Altamont Corridor Express",
      "onestop_id": "o-9q9-acealtamontcorridorexpress",
      "short_name": null,
      "tags": {
        "twitter_general": "ACE_train",
        "us_ntd_id": "90182",
        "wikidata_id": "Q434302"
      },
      "website": "http://www.acerail.com/"
    },
    {
      "agencies": [
        {
          "agency_id": "SB",
          "agency_name": "San Francisco Bay Ferry",
          "geometry": {
            "coordinates": [
              [
                [
                  -122.37725,
                  37.66268
                ],
                [
                  -122.39161,
                  37.79511
                ],
                [
                  -122.35925,
                  37.90951
                ]
              ]
            ],
            "type": "Polygon"
          },
          "id": 3804948,
          "places": [
            {
              "adm0_name": "United States of America",
              "adm1_name": "California",
              "city_name": null
            },
            {
              "adm0_name": "United States of America",
              "adm1_name": "California",
              "city_name": "Oakland"
            }
          ],
          "route_types": [
            4
          ],
          "route_types_basic": [
            4
          ]
        }
      ],
      "feeds": [
        {
          "id": 790,
          "name": null,
          "onestop_id": "f-9q9p-sanfranciscobayferry",
          "spec": "GTFS"
        },
        {
          "id": 4057,
          "name": "San Francisco Bay Area 511 Regional Feed (Daily)",
          "onestop_id": "f-sf~bay~area~rg",
          "spec": "GTFS"
        }
      ],
      "id": 14356091,
      "name": "San Francisco Bay Ferry",
      "onestop_id": "o-9q9p-sanfranciscobayferry",
      "short_name": null,
      "tags": {
        "twitter_general": "SFBayFerry",
        "twitter_service_alerts": "SFBFBayAlerts",
        "us_ntd_id": "90225",
        "wikidata_id": "Q7413935"
      },
      "website": "http://www.sanfranciscobayferry.com"
    }
  ]
}