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 Norwegian Licence for Open Government Data (NLOD) 2.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/oslobysykkel.no/gbfs.json

Response

{
  "data":{
    "nb":{
      "feeds":[
        {
          "url":"https://gbfs.urbansharing.com/oslobysykkel.no/system_information.json",
          "name":"system_information"
        },
        {
          "url":"https://gbfs.urbansharing.com/oslobysykkel.no/station_information.json",
          "name":"station_information"
        },
        {
          "url":"https://gbfs.urbansharing.com/oslobysykkel.no/station_status.json",
          "name":"station_status"
        }
      ]
    }
  },
  "ttl":10,
  "last_updated":1553592630
}

System

Machine readable basic information about Oslo City Bike

Endpoint: system_information.json (Documentation)

CURL request

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

Response

{
  "last_updated": 1553592653, 
  "ttl": 10, 
  "data": {
    "system_id": "oslobysykkel", 
    "language": "nb", 
    "name": "Oslo Bysykkel", 
    "operator": "UIP Oslo Bysykkel AS", 
    "timezone": "Europe/Oslo", 
    "phone_number": "+4791589700", 
    "email": "post@oslobysykkel.no"
  }
}

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/oslobysykkel.no/station_information.json

Response

{
  "last_updated": 1553592653,
  "data": {
    "stations": [
      {  
        "station_id":"627",
        "name":"Skøyen Stasjon",
        "address":"Skøyen Stasjon",
        "lat":59.9226729,
        "lon":10.6788129,
        "capacity":20
      },
      {  
        "station_id":"623",
        "name":"7 Juni Plassen",
        "address":"7 Juni Plassen",
        "lat":59.9150596,
        "lon":10.7312715,
        "capacity":15
      },
      {  
        "station_id":"610",
        "name":"Sotahjørnet",
        "address":"Sotahjørnet",
        "lat":59.9099822,
        "lon":10.7914482,
        "capacity":20
      }
    ]
  }
}

Availability

Bike and dock availability

Endpoint: station_status.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" \
  https://gbfs.urbansharing.com/oslobysykkel.no/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