Docs
API reference

Availability

Where there is room, now or at the time your vehicle would arrive. Availability gives counts only: you never see another operator's vehicles or bookings.

The availability object

object"availability"required
staging_areastringrequired

The staging area's id.

namestringrequired
distance_minteger or null

Metres from near, or, offered as an alternative, from the staging area you asked for. Null when there is neither.

free_spotsintegerrequired

Spots nobody has reserved at arrive_at, or now if you gave no time.

chance_freenumberrequired

How likely it is that a spot is still free when the vehicle gets there, from 0 to 1. A forecast, not a hold.

The availability object
{
  "object": "availability",
  "staging_area": "sa_norreport",
  "name": "Nørreport",
  "distance_m": 420,
  "free_spots": 3,
  "chance_free": 0.92
}

Find where there is room

GET/v1/availability

Staging areas with room, now or at arrive_at, nearest first. Pass near to search around a point, or staging_area to ask about one.

For a time ahead, chance_free is how likely it is that a spot is still free when the vehicle gets there. It is a forecast, not a hold: to be sure of a spot, reserve it.

Parameters

nearstring

Search around this point, as lat,lng.

radius_minteger

How far from near to search, in metres. Defaults to 3000.

staging_areastring

Ask about this one staging area instead of searching.

arrive_attimestamp

When the vehicle would arrive. Defaults to now.

limitinteger

How many to return, 1 to 100. Defaults to 20.

starting_afterstring

For the next page, the staging_area of the last item on this one.

Responses

200

Staging areas with room.

400
parameter_missing

Neither near nor staging_area was given.

Endpoint

GET https://api.golanoo.com/v1/availability

Request
curl https://api.golanoo.com/v1/availability \
  -H "Authorization: Bearer lk_test_..."
Response
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "availability",
      "staging_area": "sa_norreport",
      "name": "Nørreport",
      "distance_m": 420,
      "free_spots": 3,
      "chance_free": 0.92
    },
    {
      "object": "availability",
      "staging_area": "sa_israels_plads",
      "name": "Israels Plads",
      "distance_m": 780,
      "free_spots": 1,
      "chance_free": 0.61
    }
  ]
}