Parking Spaces (Live)

Returns live information about currently available parking spaces in certain multi-storey carparks.

This data is provided by the Government. See a working example: https://www.gov.je/Travel/Motoring/Parking/pages/carparkspaces.aspx

GET /v1/carparks/live-spaces

Query Params

Param	Desription
includeCarparkInfo	If set to true then full Carpark info will be included with the response (see Carparks schema)

info

The response we provide is slightly different than what the Government endpoint provides. This is done to ensure consistent formatting across our whole API.

Response

200 (OK)

This is a sample response.

Status: 200 (OK)

{
  "results": [
    {
      "name": "Green Street",
      "code": "GREENST",
      "spaces": 332,
      "status": "good",
      "open": true
    },
    {
      "name": "Minden Place",
      "code": "MINDENPL",
      "spaces": 47,
      "status": "good",
      "open": true
    }
  ],
  "timestamp": "2023-08-29T02:57:26.000Z"
}

With Carpark Info

This is a sample response. See Carparks schema for carparkInfo format.

Status: 200 (OK)

{
  "results": [
    {
      "name": "Green Street",
      "code": "GREENST",
      "spaces": 332,
      "status": "good",
      "open": true,
      "carparkInfo": {
        "id": "b81988b7-d294-4000-a69e-77d99d258b04",
        "createdAt": "2024-06-11T10:02:48.000Z",
        "name": "Green Street MS",
        "payByPhoneCode": "59812",
        "type": "LONG_STAY",
        "surfaceType": "CONCRETE",
        "multiStorey": 1,
        "latitude": "49.18132100",
        "longitude": "-2.10214100",
        "spaces": 576,
        "disabledSpaces": 8,
        "parentChildSpaces": 0,
        "electricChargingSpaces": 2,
        "liveTrackingCode": "GREENST",
        "notes": null
      }
    }
  ],
  "timestamp": "2023-08-29T02:57:26.000Z"
}

Schema

Root

Key	Type	Description
results	Array	An array of Carparks
timestamp	String	ISO 8601 timestamp of when the data was last updated

Carpark

Key	Type	Description
name	String	The human readable name of the carpark
code	String	A unique code to identify the carpark
spaces	Number	The number of empty spaces currently available
status	String	TODO
open	Boolean	true if the carpark is open, otherwise false
carparkInfo	Carpark/null	ONLY included in the response if includeCarparkInfo=true query parmeter is set

Differences from Government endpoint

Here is a sample response from the Multi-Storey carpark spaces page on gov.je:

http://sojpublicdata.blob.core.windows.net/sojpublicdata/carpark-data.json

{
    "carparkData":{
        "Jersey":{
            "carpark":[
                {
                    "name":"Green Street",
                    "code":"GREENST",
                    "spaces":332,
                    "type":"Long stay",
                    "status":"good",
                    "carparkOpen":true,
                    "carparkInformation":"",
                    "numberOfUnusableSpaces":0,
                    "numberOfSpacesConsideredLow":43
                }
            ]
        },
        "Timestamp":"This information was updated at 03:32:48 on Tuesday 29 August"
    }
}

You can compare this response with the response from our API above.

Sources

Source
Parking Spaces API