The week strip — per-date departures, riders, balance due and worst conditions

GET

/days

curl --request GET \
  --url 'https://quikstik-core.fly.dev/days?from=2026-04-15&to=2026-04-15' \
  --header 'Authorization: Bearer <token>' \
  --header 'x-tenant-id: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'

• Production

For each merchant-local date in [from, to] (inclusive, at most 14 days): the number of scheduled departures, riders on live parties, balance due on live parties, and the most severe conditions state among the day’s scheduled departures (ride < watch < guest_may_cancel < operator_call; null when none is scored). Every date in the range is present, empty days included. Same counting law, scope and zone resolution as getDay. Auth: a session, or an operator key scoped bookings.read.

Authorizations

• bearerAuth

Parameters

Header Parameters

x-tenant-id

required

string format: uuid

Tenant identifier (UUID).

Authn/authz semantics are intentionally TBD for this contract slice; this header exists to keep the contract explicitly multi-tenant from day 0.

Query Parameters

from

required

string format: date

First date, YYYY-MM-DD.

to

required

string format: date

Last date, YYYY-MM-DD; not before from, at most 13 days after it.

Responses

200

One entry per date

Media typeapplication/json

object

from

required

string format: date

to

required

string format: date

tz

required

string

days

required

Array<object>

object

date

required

string format: date

departures

required

integer

riders

required

integer

balance_due_minor

required

integer format: int64

conditions_worst

required

string

nullable

Allowed values: ride watch guest_may_cancel operator_call

Example

{
  "days": [
    {
      "conditions_worst": "ride"
    }
  ]
}

401

Invalid_session

403

Operator key without bookings.read

409

Time_zone_unresolved or mixed_currency

Media typeapplication/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}

422

Invalid_date, invalid_range (from after to), or range_too_long (> 14 days)

Media typeapplication/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}

503

Days_unavailable

Media typeapplication/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}