Retrieve an existing address-free schedule using its saved property token

The stable, cacheable answer for a property — what reminder engines re-check with If-None-Match (a 304 costs us nothing; the ETag changes only when schedule content changes, e.g. a bank-holiday reschedule). property_token is the service-issued property_id without its internal p: namespace marker; logs treat both forms as personal data. Old p: path values permanently redirect to the prefix-free form.

Stale-while-revalidate: a stale stored schedule is served as-is (its retrieved_at is the honest staleness signal) while a refresh happens in the background — staleness is NEVER a 404. 404 no_schedule means only "we have never answered for this property" — create a lookup.

This representation is intentionally address-free. A property_id is not authentication, so the exact council-rendered address is returned only inside the private, no-store Lookup resource.

get/schedules/{property_token}

Request

  • Base URL: https://whenisbins.com/v1
  • URL: https://whenisbins.com/v1/schedules/{property_token}
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

property_tokenstring required
Example:4c5ee6c2f2c7c959

Query parameters

view'compact'

compact returns the CompactSchedule: the same answer with every container-appearance block and the legacy colour fields removed from each collection, for a reminder or "what goes out tomorrow?" check (about 1 KB against about 9 KB). Nothing about which answer is served, its freshness or the refresh it may queue changes. The compact body has its own ETag; send back the one received for the same view. Any other value is 400 invalid_request.

Headers

If-None-Matchstring
Example:"a1b2c3"

Response

The current schedule; the CompactSchedule when view=compact was requested.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.