PTV Timetable API

Hello and welcome

Hi and welcome to the PTV Timetable API.

The API has been created to provide public transport timetable data to the public in the most dynamic and efficient way. By providing an API, PTV hopes to maximise both the opportunities for re-use of public transport data and the potential for innovation.

Version 3 - NEW

PTV has released a new Version 3 of the PTV Timetable API, documented in Swagger. Version 3 provides the same data as Version 2 in a different way.

Note: By clicking the Version 3 Swagger link below you are agreeing to the Licence terms of use outlined on this page.

Proceed to Version 3 in Swagger

Version 2

A fourth release of Version 2 of the PTV Timetable API – Version 2.3.0 – is now available.

Note: By clicking the Version 2 documentation links below you are agreeing to the Licence terms of use outlined on this page.

Download the complete suite of documentation for Version 2.3.0

Proceed to the online technical reference documentation for Version 2.3.0 (this is a sub-section of the complete documentation and does not include information on registering for an API key)

Resources

Registering for an API key and calculating a signature

You will need a user ID and an API key in order to use the API. You'll also need to calculate and pass along a signature in each request for the API to work.

Download instructions on how to register for an API key and calculate a signature (RTF)

Migration guide

A migration guide has been created to assist API users moving from Version 2 to Version 3.

Download the V2 to V3 Migration Guide (PDF)

Download the accessible version of the V2 to V3 Migration Guide (DOCX)

Frequently asked questions

For more information, see the Frequently asked questions (FAQs).

Note: All information about how to use the API is in the Swagger (for Version 3) or the documentation (for Version 2). PTV cannot provide technical support for the API.

Data Quality Statement

View the Data Quality Statement to understand more about the quality of the data provided by the API and how to use it.

Licence

Ownership of intellectual property rights in the PTV Timetable API Documentation

Unless otherwise noted, copyright (and any other intellectual property rights, if any) in the PTV Timetable API Documentation is owned by Public Transport Victoria (referred to below as PTV).

Don’t use our IP

You may use the data accessed by the API (PTV Timetable API Data) as permitted by the below licence, and you may use the PTV Timetable API Documentation to access the PTV Timetable API Data, but you are not permitted to use PTV’s intellectual property (including copyright, registered and unregistered trade marks) for any other purpose.

Creative Commons licence

The PTV Timetable API Data is licensed under a Creative Commons Attribution 4.0 International Licence.

Creative Commons - Attribution licence image

Creative Commons Attribution 4.0 International Licence is a standard form licence agreement that allows you to copy, distribute, transmit and adapt the PTV Timetable API Data provided that you attribute the work. Both a summary of the licence terms and the full licence terms are available online from Creative Commons.

PTV requests that you attribute the PTV Timetable API Data using the following wording:

Source: Licensed from Public Transport Victoria under a Creative Commons Attribution 4.0 International Licence.

Don’t pretend to be us

When you use the PTV Timetable API Data, don’t pretend to be PTV or claim that PTV has endorsed your product or service.

Disclaimer

Your use is your responsibility

The PTV Timetable API Data is provided “as is” and PTV is not liable for how you use this data, how third parties use or rely on this data or any errors contained within the data. You are responsible for determining whether the PTV Timetable API Data is suitable for your particular usage and purposes.