PTV Timetable API
Hello and welcome
Hi and welcome to our 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, we hope to maximise both the opportunities for re-use of public transport data and the potential for innovation.
Version 3 - Latest version
We've released Version 3 of the PTV Timetable API, documented in Swagger. Version 3 provides the same data as Version 2 in a different way.
A fourth release of Version 2 of the PTV Timetable API – Version 2.3.0 – is now available.
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.
A migration guide has been created to assist API users moving from Version 2 to Version 3.
Download V2 to V3 Migration Guide (PDF) 321 KB
Download V2 to V3 Migration Guide - accessible version (DOCX) 212 KB
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 can't 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.
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 aren't 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 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.
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.