Catalog/gbfs-nearby-availability

Data

Nearest bikeshare stations to a point with live bikes/docks API

Given a system_id and a coordinate, JOINs live station_status with station_information and ranks the nearest stations by great-circle distance, returning live bikes/e-bikes/docks available, capacity, fill %, and rentability per station. By default only returns stations that actually have a bike to rent. Answers 'where's the nearest Citi Bike with a bike right now?', 'which dock near me has open slots to return a bike?'.

Price$0.01per request
MethodPOST
Route/v1/data/gbfs-nearby-availability
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache60s public
datatransitmicromobilitybikesharegbfsnearbygeosearchavailability
API URLhttps://x402.hexl.dev/v1/data/gbfs-nearby-availability
Integration docs
Example request
{
  "systemId": "lyft_nyc",
  "latitude": 40.758,
  "longitude": -73.9855,
  "limit": 3
}
Example response
{
  "systemId": "lyft_nyc",
  "systemName": "Citi Bike",
  "latitude": 40.758,
  "longitude": -73.9855,
  "requireBike": true,
  "nearestStations": [
    {
      "stationId": "66dca682-0aca-11e7-82f6-3863bb44ef7c",
      "name": "W 45 St & 8 Ave",
      "distanceKm": 0.298,
      "bikesAvailable": 14,
      "ebikesAvailable": 0,
      "docksAvailable": 46,
      "capacity": 65,
      "fillPct": 21.5,
      "isRenting": true,
      "latitude": 40.75929124,
      "longitude": -73.98859651
    },
    {
      "stationId": "66dc3f08-0aca-11e7-82f6-3863bb44ef7c",
      "name": "W 41 St & 8 Ave",
      "distanceKm": 0.42,
      "bikesAvailable": 66,
      "ebikesAvailable": 22,
      "docksAvailable": 31,
      "capacity": 105,
      "fillPct": 62.9,
      "isRenting": true,
      "latitude": 40.75640548,
      "longitude": -73.9900262
    }
  ]
}
Input schema
{
  "type": "object",
  "properties": {
    "systemId": {
      "type": "string"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 5
    },
    "requireBike": {
      "type": "boolean",
      "default": true,
      "description": "Only return stations currently renting with bikes>0"
    }
  },
  "required": [
    "systemId",
    "latitude",
    "longitude"
  ],
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}