integrations.sh
← all integrations

PTV Timetable API - Version 3

OpenAPI apis-guru transport

The PTV Timetable API provides direct access to Public Transport Victoria’s public transport timetable data.

The API returns scheduled timetable, route and stop data for all metropolitan and regional train, tram and bus services in Victoria, including Night Network(Night Train and Night Tram data are included in metropolitan train and tram services data, respectively, whereas Night Bus is a separate route type).

The API also returns real-time data for metropolitan train, tram and bus services (where this data is made available to PTV), as well as disruption information, stop facility information, and access to myki ticket outlet data.

This Swagger is for Version 3 of the PTV Timetable API. By using this documentation you agree to comply with the licence and terms of service.

Train timetable data is updated daily, while the remaining data is updated weekly, taking into account any planned timetable changes (for example, due to holidays or planned disruptions). The PTV timetable API is the same API used by PTV for its apps. To access the most up to date data PTV has (including real-time data) you must use the API dynamically.

You can access the PTV Timetable API through a HTTP or HTTPS interface, as follows:

base URL / version number / API name / query string

The base URL is either:

  • or

The Swagger JSON file is available at

Frequently asked questions are available on the PTV website at

Links to the following information are also provided on the PTV website at

  • How to register for an API key and calculate a signature
  • PTV Timetable API V2 to V3 Migration Guide
  • Documentation for Version 2 of the PTV Timetable API
  • PTV Timetable API Data Quality Statement

All information about how to use the API is in this documentation. PTV cannot provide technical support for the API.

Credits: This page has been based on Steve Bennett's , used with permission.

Homepage
https://api.apis.guru/v2/specs/ptv.vic.gov.au/v3.json
Provider
ptv.vic.gov.au
OpenAPI version
3.0.0
Spec (JSON)
https://api.apis.guru/v2/specs/ptv.vic.gov.au/v3/openapi.json
Spec (YAML)
https://api.apis.guru/v2/specs/ptv.vic.gov.au/v3/openapi.yaml

Tools (28)

Extracted live via the executor SDK.

  • departures.departuresGetForStop

    View departures for all routes from a stop

  • departures.departuresGetForStopAndRoute

    View departures for a specific route from a stop

  • directions.directionsForDirection

    View all routes for a direction of travel

  • directions.directionsForDirectionAndType

    View all routes of a particular type for a direction of travel

  • directions.directionsForRoute

    View directions that a route travels in

  • disruptions.disruptionsGetAllDisruptions

    View all disruptions for all route types

  • disruptions.disruptionsGetDisruptionById

    View a specific disruption

  • disruptions.disruptionsGetDisruptionModes

    Get all disruption modes

  • disruptions.disruptionsGetDisruptionsByRoute

    View all disruptions for a particular route

  • disruptions.disruptionsGetDisruptionsByRouteAndStop

    View all disruptions for a particular route and stop

  • disruptions.disruptionsGetDisruptionsByStop

    View all disruptions for a particular stop

  • fareEstimate.fareEstimateGetFareEstimateByZone

    Estimate a fare by zone

  • outlets.outletsGetAllOutlets

    List all ticket outlets

  • outlets.outletsGetOutletsByGeolocation

    List ticket outlets near a specific location

  • patterns.patternsGetPatternByRun

    View the stopping pattern for a specific trip/service run

  • routes.routesOneOrMoreRoutes

    View route names and numbers for all routes

  • routes.routesRouteFromId

    View route name and number for specific route ID

  • routeTypes.routeTypesGetRouteTypes

    View all route types and their names

  • runs.runsForRoute

    View all trip/service runs for a specific route ID

  • runs.runsForRouteAndRouteType

    View all trip/service runs for a specific route ID and route type

  • runs.runsForRun

    View all trip/service runs for a specific run_ref

  • runs.runsForRunAndRouteType

    View the trip/service run for a specific run_ref and route type

  • search.searchSearch

    View stops, routes and myki ticket outlets that match the search term

  • stops.stopsStopDetails

    View facilities at a specific stop (Metro and V/Line stations only)

  • stops.stopsStopsByGeolocation

    View all stops near a specific location

  • stops.stopsStopsForRoute

    View all stops on a specific route

  • openapi.previewSpec

    Preview an OpenAPI document before adding it as a source

  • openapi.addSource

    Add an OpenAPI source and register its operations as tools