History

Read historical fare and delay patterns

Returns recorded fare and delay summaries for one route and traveller profile. Historical patterns are not future guarantees.

get/v1/routes/{routeId}/insights

Request

  • Base URL: https://sweetsaverfare.com
  • URL: https://sweetsaverfare.com/v1/routes/{routeId}/insights
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://sweetsaverfare.com/oauth/auth, token URL https://sweetsaverfare.com/oauth/token, scopes: fares:read)

Path parameters

routeId'TSA_SWB' | 'SWB_TSA' | 'TSA_DUK' | 'DUK_TSA' | 'TSA_NAN' | 'HSB_NAN' | 'NAN_HSB' | 'SWB_FUL' | 'FUL_SWB' | 'HSB_LNG' | 'LNG_HSB' | 'ERL_SLT' | 'SLT_ERL' | 'CMX_PWR' | 'PWR_CMX' required

Supported route identifier in the URL path.

Query parameters

profile_id'ADULT_NO_VEHICLE' | 'ADULT_STANDARD_VEHICLE' | 'ADULT_OVERHEIGHT_VEHICLE'

Traveller and vehicle profile used for comparable fare evidence.

Response

Route fare and delay patterns

observation_idstring uuid nullable required
observed_atstring date-time required
stale_afterstring date-time required
freshness_state'fresh' | 'stale' | 'expired' required
source_status'ok' | 'missing' | 'provider_queue_active' | 'session_expired' | 'blocked' | 'unknown' required
data_source'demo' | 'fake_worker' | 'fixture' | 'live_provider' | 'schedule_reference' required
parser_versionstring required
observation_trace_idstring nullable required
fixture_shastring nullable required
observation_outcome'verified' | 'partial' | 'unavailable' | 'failed'
disclaimer'Ferry fares can change. Confirm final availability and price directly with BC Ferries before making travel decisions.' required
route_id'TSA_SWB' | 'SWB_TSA' | 'TSA_DUK' | 'DUK_TSA' | 'TSA_NAN' | 'HSB_NAN' | 'NAN_HSB' | 'SWB_FUL' | 'FUL_SWB' | 'HSB_LNG' | 'LNG_HSB' | 'ERL_SLT' | 'SLT_ERL' | 'CMX_PWR' | 'PWR_CMX' required
profile_id'ADULT_NO_VEHICLE' | 'ADULT_STANDARD_VEHICLE' | 'ADULT_OVERHEIGHT_VEHICLE' required
period_startstring date required
period_endstring date required

Changes

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