Realtime data

Real time data is available in the GBFS format (General Bikeshare Feed Specification). More details are available on GitHub. The data is updated every 10 seconds.

The data is published under the Open Government Licence (OGL) v3.0

Identification in header

All requests to our real time API should send the Client-Identifier header. This should contain a value that describes the application accessing the API. The value should contain your company/organization name, follwed by a dash and the application's name, like mycompany-travelplanner or myname-citymonitor.

Endpoints

Auto discovery

Auto-discovery file that links to all of the other files published by the system.

Endpoint: gbfs.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" https://gbfs.urbansharing.com/edinburghcyclehire.com/gbfs.json

Response

{
  "data":{
    "en":{
      "feeds":[
        {
          "url":"https://gbfs.urbansharing.com/edinburghcyclehire.com/system_information.json",
          "name":"system_information"
        },
        {
          "url":"https://gbfs.urbansharing.com/edinburghcyclehire.com/station_information.json",
          "name":"station_information"
        },
        {
          "url":"https://gbfs.urbansharing.com/edinburghcyclehire.com/station_status.json",
          "name":"station_status"
        }
      ]
    }
  },
  "ttl":10,
  "last_updated":1542035150
}

System

Machine readable basic information about Just Eat Cycles

Endpoint: system_information.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" \
  https://gbfs.urbansharing.com/edinburghcyclehire.com/system_information.json

Response

{
  "last_updated": 1540309639,
  "ttl": 10,
  "data": {
    "system_id": "edinburgh-city-bikes",
    "language": "en",
    "name": "Just Eat Cycles",
    "operator": "SERCO",
    "timezone": "Europe/London",
    "phone_number": "+4401312783000",
    "email": "support@edinburghcyclehire.com"
  }
}

Stations

Information about all stations, including geolocation, addresses and descriptions

Endpoint: station_information.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" \
  https://gbfs.urbansharing.com/edinburghcyclehire.com/station_information.json

Response

{
 "last_updated": 1540310074,
 "data": {
    "stations": [
       {
          "address": "Ocean Drive",
          "capacity": 25,
          "lon": -3.176351263805259,
          "name": "Ocean Terminal",
          "station_id": "285",
          "lat": 55.981286014792985
       },
       {
          "address": "Vanburgh Place",
          "capacity": 37,
          "lon": -3.1668846170233564,
          "name": "Leith Links",
          "station_id": "284",
          "lat": 55.96919856910954
       },
       {
          "address": "Near Waitrose Car Park Entrance",
          "capacity": 20,
          "lon": -3.2234280553759618,
          "name": "Waitrose, Comely Bank",
          "station_id": "277",
          "lat": 55.959504176688824
       }
     ]
   }
 }

Availability

Bike and dock availability

Endpoint: station_status.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" \
  https://gbfs.urbansharing.com/edinburghcyclehire.com/station_status.json

Response

{
  "last_updated": 1540219230,
  "data": {
    "stations": [
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 7,
        "num_docks_available": 5,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "175"
      },
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 4,
        "num_docks_available": 8,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "47"
      },
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 4,
        "num_docks_available": 9,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "10"
      }
    ]
  }
}

Historical data

You may also download anonymised trip records