Skip to content

The nights a rider the rider flagged is going to

GET
/me/flagged
curl --request GET \
--url 'https://biiikes.com/api/me/flagged?metro=pdx&from=2026-10-01&to=2026-10-07' \
--header 'Authorization: Bearer <token>'

Night by night from from to to (at most 31 days) in one metro, the nights where a rider the rider flagged said going or confirmed, each with those riders’ display names and handles. For marking the public calendar’s nights, which carry no flags.

metro
required
string
/^[a-z0-9-]{2,32}$/
Example
pdx
from
required
string format: date
Example
2026-10-01
to
required
string format: date
Example
2026-10-07

Night by night

Media typeapplication/json
object
nights
required
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": [
{
"ride": "zdh5pnp",
"day": "2026-10-03",
"riders": [
{
"handle": "samrides",
"name": "Sam"
}
]
}
]
}

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

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

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