Sailings

Read near-term sailing status and fares

Returns upcoming sailing status, saved fare evidence, and reported vehicle-space information for a supported route. Set request_refresh=false to avoid requesting internal refresh work.

get/v1/sailings/soon

Request

  • Base URL: https://sweetsaverfare.com
  • URL: https://sweetsaverfare.com/v1/sailings/soon
  • 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)

Query parameters

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

Supported Sweet Saver Fare route identifier.

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

Traveller and vehicle profile used for comparable fare evidence.

hoursinteger

Number of upcoming hours to include, from 1 through 48.

request_refreshboolean

Defaults to true and may attach to or enqueue an internal current-conditions refresh. Set false for a saved-evidence read that does not request work.

Response

Near-term sailing status and fares

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
hoursinteger required
status_refresh'served_from_cache' | 'attached_to_job' | 'queued' | 'waiting_room_active' required
status_demand_idstring nullable required

Changes

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