Matka.fi API Developer’s Guide
The Finnish Transport Agency (FTA) offers the access right to Matka.fi (Journey.fi) API when the application or service supports public transport usage and public transport information provision. Development and testing as well as commercial use of interfaces is free of charge.
There are three possible ways to access timetable and route data:
HTTP GET interface, which gives a response in XML format. NOTE: The current GET interfaces will be closed down by end of 2016. Please, explore Digitransit (beta).
Kalkati.net formatted XML database dump file, which includes the whole Matka.fi stop, route and timetable information in a single file.
GTFS dump. Please notice that this is a test version and it will have a few changes - api.matka.fi/data/gtfs.zip
The documentation is available only in English and FTA takes no responsibility for possible errors or damages caused by documentation or data. If you find an error or have an suggestion for how to improve the documentation, please give feedback on the contact form.
If you need more information or assistance, please use the contact form. FTA reserves the right to inspect applications and services before granting access rights to the interface. FTA has right to abolish access rights whenever necessary, for example in case of excessive traffic to the interface or misuse of the service.
Access to the interfaces is requested on the account request form.
The content of the matka.fi database covers timetables and routes for buses, trains, local public transport and air traffic.
The Matka.fi data is published in accordance with FTA´s Open data License (also in Finnish and Swedish).
New content will be added without further notice.
FTA does not guarantee continued supply of the information.
The route suggestions are based on estimated travel times. The actual completion of the suggested connections cannot be guaranteed. Finnish Transport Agency is not liable for damages which may be caused by errors in the data or the failure of a suggested public transport connection.
The data provided by the Centres for Economic Development, Transport and the Environment is by origin not very detailed. Only the main stops on the routes are included. Matka.fi therefore has to fill in the intermediate stops. This process might lead to errors in the data.
Also lack of data in the database (minor cities and municipalities) or errors may affect the quality of the route suggestions.