Catalog/gbfs-systems

Data

Search the global GBFS bikeshare/scooter system catalog API

Searches the MobilityData GBFS catalog (~1500 published bikeshare & dockless-scooter systems worldwide) by free-text name/city and/or country code, returning each system's stable system_id, operator URL, supported GBFS versions, and the keyless auto-discovery URL needed by the other endpoints. Answers 'what bikeshare systems exist in Germany?', 'what is Citi Bike's GBFS system_id?'.

Price$0.01per request
MethodPOST
Route/v1/data/gbfs-systems
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache21600s public
datatransitmicromobilitybikesharegbfsscootermobilitycatalog
API URLhttps://x402.hexl.dev/v1/data/gbfs-systems
Integration docs
Example request
{
  "query": "citi bike",
  "country": "US",
  "limit": 3
}
Example response
{
  "query": "citi bike",
  "country": "US",
  "totalSystemsInCatalog": 1506,
  "matchCount": 1,
  "systems": [
    {
      "systemId": "lyft_nyc",
      "name": "Citi Bike",
      "location": "New York, NY",
      "countryCode": "US",
      "operatorUrl": "https://www.citibikenyc.com",
      "autoDiscoveryUrl": "https://gbfs.citibikenyc.com/gbfs/2.3/gbfs.json",
      "supportedVersions": [
        "2.3"
      ]
    }
  ]
}
Input schema
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text match on system name, city, or system_id"
    },
    "country": {
      "type": "string",
      "description": "ISO 3166 alpha-2 country code filter, e.g. US"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    }
  },
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}