data.lime.bike APIdata.lime.bike ↗
Access real-time Lime bike and scooter locations, station status, and system metadata across multiple cities via GBFS-compliant endpoints.
curl -X GET 'https://api.parse.bot/scraper/821870f9-1a42-4a64-bf0c-86e2253358ba/get_gbfs_discovery?region=washington_dc' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the GBFS auto-discovery feed for a specific region. Returns a list of available feed URLs (e.g., system_information, station_information, station_status, free_bike_status).
| Param | Type | Description |
|---|---|---|
| regionrequired | string | Lime region identifier (e.g. 'washington_dc', 'new_york', 'chicago'). |
{
"type": "object",
"fields": {
"ttl": "integer, seconds until next update",
"data": "object containing language-keyed feeds with name and url for each available feed",
"version": "string, GBFS version",
"last_updated": "integer, UNIX timestamp of last data update"
},
"sample": {
"data": {
"ttl": 0,
"data": {
"en": {
"feeds": [
{
"url": "https://data.lime.bike/api/partners/v1/gbfs/washington_dc/system_information",
"name": "system_information"
},
{
"url": "https://data.lime.bike/api/partners/v1/gbfs/washington_dc/station_information",
"name": "station_information"
},
{
"url": "https://data.lime.bike/api/partners/v1/gbfs/washington_dc/station_status",
"name": "station_status"
},
{
"url": "https://data.lime.bike/api/partners/v1/gbfs/washington_dc/free_bike_status",
"name": "free_bike_status"
}
]
}
},
"version": "1.0",
"last_updated": 1777801085
},
"status": "success"
}
}About the data.lime.bike API
This API exposes 5 GBFS-compliant endpoints for Lime's micromobility network, covering vehicle locations, station status, and system metadata across dozens of regions. The get_free_bike_status endpoint returns per-vehicle coordinates, reservation state, disabled state, and vehicle type for every available bike or scooter in a given region in real time. All endpoints accept a region parameter and return standardized GBFS fields including last_updated, ttl, and versioned data objects.
Vehicle and Station Data
The get_free_bike_status endpoint is the core feed for real-time vehicle tracking. For each vehicle in the bikes array it returns bike_id, lat, lon, is_reserved, is_disabled, and vehicle_type. Where available, rental_uris are included per vehicle, allowing deep-link integration with rental flows. The region parameter accepts identifiers like washington_dc, new_york, or chicago.
Station data comes in two feeds. get_station_information returns the static record for each logical station — station_id, name, lat, lon — while get_station_status provides the live operational view: num_vehicles_available, num_docks_available, is_installed, is_renting, and is_returning. Because Lime operates a dockless fleet, most regions surface a single virtual station rather than a physical dock network.
System Metadata and Discovery
get_system_information returns static regional metadata: system_id, language, name, timezone, license_url, and attribution_organization_name. This is useful for populating UI labels, respecting license attribution, and confirming timezone context when interpreting last_updated timestamps.
The get_gbfs_discovery endpoint returns the canonical list of available feed URLs for a given region, keyed by language. This is the standard GBFS auto-discovery pattern — it tells you which of the other feeds are actually published for that region before you query them individually. Every response across all endpoints includes a ttl field (seconds until next refresh) and a last_updated UNIX timestamp so callers can schedule polling efficiently.
- Map all available Lime scooters and bikes near a location using
lat/lonfromget_free_bike_status - Filter out reserved or disabled vehicles using
is_reservedandis_disabledflags before surfacing results to users - Build a multi-city micromobility dashboard by iterating over region identifiers and aggregating
num_vehicles_availablefromget_station_status - Attribute map data correctly by pulling
attribution_organization_nameandlicense_urlfromget_system_information - Check which GBFS feeds are active for a new region before querying vehicle or station endpoints, using
get_gbfs_discovery - Track fleet utilization over time by polling
get_free_bike_statusper region and recording vehicle counts at intervals - Integrate deep-link rental flows into a mobility app using
rental_urisreturned per vehicle inget_free_bike_status
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Lime publish an official developer API?+
What does `get_free_bike_status` return and how granular is the vehicle data?+
bike_id, precise lat/lon coordinates, a vehicle_type field, boolean flags for is_reserved and is_disabled, and optional rental_uris. Battery level, pricing, or trip history are not included in this feed.Does the API cover all Lime markets globally, or only certain regions?+
region parameter supports identifiers for cities where Lime publishes GBFS data, such as washington_dc, new_york, and chicago. Not every Lime market worldwide is guaranteed to have a published feed, and the set of available regions can change as Lime expands or suspends service. You can fork this API on Parse and revise it to add a region-listing endpoint that enumerates currently active regions.Are geofencing zones or service area boundaries available through this API?+
How fresh is the data returned by these endpoints?+
last_updated UNIX timestamp and a ttl integer (seconds until the next expected update). For get_free_bike_status, typical TTL values are in the range of 30–60 seconds, but this varies by region. Callers should respect the ttl to avoid fetching stale or redundant data.