Skip to content

Citybikes v2

The Citybikes v2 format is simple and ready to be used as is. It has been around since the project started and is our reference implementation for exposing the data extracted using pybikes.

Network list

This endpoint provides enough information to create a listing of available networks.

https://api.citybik.es/v2/networks

json
{
  "networks": [
    {
        "company": "JCDecaux", 
        "href": "/v2/networks/velib", <--- network API endpoint
        "location": {
          "latitude": 48.856612, 
          "city": "Paris", 
          "longitude": 2.352233, 
          "country": "FRA"
        }, 
        "name": "Vélib'", 
        "id": "velib"
    },
    {...}
  ]
}

Network

Information about a network and its resources.

https://api.citybik.es/v2/networks/<network_id>

json
{
  "network": {
    "name": "Vélib'",
    "stations": [
      {
          "name": "00903 - QUAI MAURIAC  / PONT DE BERCY",   /   UTC Zulu timestamp of the last time
          "timestamp": "2014-04-14T12:10:17.622Z",  <-------/ the station was updated on our systems
          "longitude": 2.374340554605615,
          "free_bikes": 1,   <-------------------------- Available bikes
          "latitude": 48.83713368945151,
          "empty_slots": 19,  <------------------------- Empty spaces
          "id": "f5a551a87eec15155d6409fe9d0ff8e2", <---- Unique id for this station
          "extra": {
              "uid": "22002",             
              "renting": 1,                  Extra information
              "returning": 1,             
              "last_updated": 1741185478,    Information that is not constant
              "slots": 0,                 ├─  or always available between
              "station_id": 34300292,        different networks
              "banking": false,           
              "payment-terminal": false,  
              "normal_bikes": 7,          
              "ebikes": 3
          }
      },
      {...}
    ],
    "company": "JCDecaux",           
    "href": "/v2/networks/velib",              Redundant Information
    "location": {                    
      "latitude": 48.856612,               Just so you know where you are
      "city": "Paris",               ├─           with less requests
      "longitude": 2.352233,         
      "country": "FRA"      This can be filtered by passing
    },                                       ?fields=stations to the URI
    "id": "velib"
  }
}