Skip to content
Biiikes API

One ride and the dates it meets

GET
/rides/{ride}
curl --request GET \
  --url https://biiikes.com/api/rides/zdh5pnp \
  --header 'X-Api-Key: <X-Api-Key>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
ride
required
string
/^[a-z0-9]{4,32}$/
Example
zdh5pnp

Responses

Section titled “Responses”

200

Section titled “200”

The ride

Media typeapplication/json
object
ride
required
string
/^[a-z0-9]{4,32}$/
title
required
string
description
required
string | null
type
required
string
metro
required
string
nights
required

The nights the ride’s page lists.

Array<object>

One date of one ride, as anybody may read it. Names no rider.

object
ride
required

The ride’s public id.

string
/^[a-z0-9]{4,32}$/
title
required
string
day
required
string format: date
meet_time
required

Local wall-clock time in the metro’s zone.

string | null
/^[0-2][0-9]:[0-5][0-9]$/
time_zone
required

The metro’s IANA zone.

string
status
required
string
Allowed values: on cancelled
cancellation_reason
required
string | null
past
required
boolean
going_count
required
integer
meeting
required

Where a night meets, exactly as the signed-out page shows it.

object
withheld
required

The leader marked the meeting point secret; nothing about where it is is published (decision 465).

boolean
place_name
required

Where the ride meets, as the page names it. Null when withheld.

string | null
neighbourhood
required

The district. For a withheld point, only when the leader chose to show it.

string | null
neighbourhood_slug
required

The district’s slug, which search’s where takes (decision 1196). Null where the neighbourhood is not shown or is a city rather than a district; names repeat across cities, slugs do not.

string | null
/^[a-z0-9-]{1,80}$/
url
required

The night’s page.

string format: uri
url
required
string format: uri
Example
{
  "ride": "zdh5pnp",
  "title": "Forest Park Gravel",
  "description": "A gravel loop through Forest Park, back by eleven.",
  "type": "ride",
  "metro": "pdx",
  "nights": [
    {
      "ride": "zdh5pnp",
      "title": "Forest Park Gravel",
      "day": "2026-10-03",
      "meet_time": "09:00",
      "time_zone": "America/Los_Angeles",
      "status": "on",
      "cancellation_reason": null,
      "past": false,
      "going_count": 8,
      "meeting": {
        "withheld": false,
        "place_name": "Jamison Square",
        "neighbourhood": "Pearl District",
        "neighbourhood_slug": "portland-pearl-district"
      },
      "url": "https://biiikes.com/pdx/forest-park-gravel-zdh5pnp/2026-10-03"
    }
  ],
  "url": "https://biiikes.com/pdx/forest-park-gravel-zdh5pnp"
}

400

Section titled “400”

An input its schema refuses

Media typeapplication/json
object
error
required
string
Allowed values: invalid_request not_found invalid_key
input
required
string | null
detail
required
string | null
Example
{
  "error": "invalid_request",
  "input": "day",
  "detail": "is not a date, YYYY-MM-DD"
}

401

Section titled “401”

No live developer key, and no rider’s sign-in token: the same answer for a missing, unknown or deleted key.

Media typeapplication/json
object
error
required
string
Allowed values: invalid_request not_found invalid_key
input
required
string | null
detail
required
string | null
Example
{
  "error": "invalid_request",
  "input": "day",
  "detail": "is not a date, YYYY-MM-DD"
}

404

Section titled “404”

No such posted ride

Media typeapplication/json
object
error
required
string
Allowed values: invalid_request not_found invalid_key
input
required
string | null
detail
required
string | null
Example
{
  "error": "invalid_request",
  "input": "day",
  "detail": "is not a date, YYYY-MM-DD"
}