Skip to content
Biiikes API

One day of a metro's calendar

GET
/metros/{metro}/days/{day}
curl --request GET \
  --url 'https://biiikes.com/api/metros/pdx/days/2026-10-03?q=gravel&far=10_to_20&who=General&where=portland-pearl-district' \
  --header 'X-Api-Key: <X-Api-Key>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
metro
required
string
/^[a-z0-9-]{2,32}$/
Example
pdx
day
required
string format: date
Example
2026-10-03

Query Parameters

Section titled “Query Parameters”
q
string
>= 2 characters <= 200 characters

Words, each matched in a ride’s title or its meeting place’s name, as the website’s search matches them.

Example
gravel
far
Array<string>
unique items
Allowed values: under_5 5_to_10 10_to_20 20_to_40 over_40

Distance bands, any of them. A ride that never stated a distance shows under every band.

Example
?far=10_to_20
who
Array<string>
unique items
Allowed values: General Family Friendly 21+ Only

Who a ride is for, any of these. A ride that never said shows under every one.

Example
?who=General
where
Array<string>
unique items

Neighborhoods, any of them, by the district slug a meeting carries. A withheld meeting point is in none.

Example
?where=portland-pearl-district

Responses

Section titled “Responses”

200

Section titled “200”

The day’s nights

Media typeapplication/json
object
metro
required
string
day
required
string format: date
nights
required
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
Example
{
  "metro": "pdx",
  "day": "2026-10-03",
  "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"
    }
  ]
}

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 metro

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"
}