Resolve a GBFS system's feeds, metadata & vehicle types API

Resolves a system_id to its live GBFS auto-discovery document, normalizing the GBFS v2 (language-nested) vs v3 (flat) feed shapes into one inventory, and joins in normalized system metadata (operator, timezone, start date) plus the vehicle-type fleet (form factor, propulsion, max range). Flags whether the system has docked stations and/or dockless free-floating vehicles. Answers 'does this system have e-bikes and what's their range?', 'is this a docked or dockless system?'.

Price$0.01per request

MethodPOST

Route/v1/data/gbfs-system-info

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache21600s public

datatransitmicromobilitybikesharegbfsscooterebikevehicle-types

API URLhttps://x402.hexl.dev/v1/data/gbfs-system-info

Integration docs

Example request

{
  "systemId": "lyft_nyc"
}

Example response

{
  "systemId": "lyft_nyc",
  "catalogName": "Citi Bike",
  "location": "New York, NY",
  "countryCode": "US",
  "system": {
    "name": "Citi Bike",
    "operator": "Lyft",
    "timezone": "America/New_York",
    "language": "en",
    "url": "http://www.citibikenyc.com",
    "startDate": "2013-05-01",
    "phoneNumber": null
  },
  "availableFeeds": [
    "gbfs",
    "system_information",
    "station_information",
    "station_status",
    "free_bike_status",
    "system_hours",
    "system_calendar",
    "system_regions",
    "system_pricing_plans",
    "system_alerts",
    "gbfs_versions",
    "vehicle_types"
  ],
  "hasStations": true,
  "hasDocklessVehicles": true,
  "vehicleTypes": [
    {
      "vehicleTypeId": "1",
      "formFactor": "bicycle",
      "propulsionType": "human",
      "maxRangeMeters": null
    },
    {
      "vehicleTypeId": "2",
      "formFactor": "bicycle",
      "propulsionType": "electric_assist",
      "maxRangeMeters": 69202
    }
  ],
  "supportedVersions": [
    "2.3"
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "systemId": {
      "type": "string",
      "description": "GBFS system_id from gbfs-systems, e.g. lyft_nyc"
    }
  },
  "required": [
    "systemId"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}