Skip to content
Biiikes API

The rider's nights and why each is theirs

GET
/me/nights
curl --request GET \
  --url https://biiikes.com/api/me/nights \
  --header 'Authorization: Bearer <token>'

The rider’s nights from 30 days ago to 90 days ahead, each with why it is theirs, as their own calendar shows them.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

The rider’s nights

Media typeapplication/json
object
nights
required
Array<object>

One of the rider’s nights and why it is theirs.

object
night
required

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
why
required
string
Allowed values: led going ridden saved
flagged
required

The riders the rider flagged on these nights.

Array<object>

One night with riders the reader flagged going to it or confirmed. Only ever answered to the rider who made the flags; a flag shows even when the flagged rider blocked the reader.

object
ride
required
string
/^[a-z0-9]{4,32}$/
day
required
string format: date
riders
required
Array<object>
>= 1 items

A rider the reader flagged: their display name and handle, and nothing else.

object
handle
required
string
name
required
string | null
Example
{
  "nights": [
    {
      "night": {
        "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"
      },
      "why": "led"
    }
  ],
  "flagged": [
    {
      "ride": "zdh5pnp",
      "day": "2026-10-03",
      "riders": [
        {
          "handle": "samrides",
          "name": "Sam"
        }
      ]
    }
  ]
}

401

Section titled “401”

No live token for this resource. WWW-Authenticate names the resource’s metadata.