Getting started - MO

 

As a MaaS operator or other actor to get ticket products from transport service providers into your own service for resale by using our Maritime MaaS API, please follow the instructions given below:

 

  1. Please familiarise yourself with the technical documentation of the Maritime MaaS API

    The technical documentation consists of:
    - GTFS schema descriptions for transport data
    - Booking API descriptions
    - Ticket data model recommendation

  2. You need a valid agreement on ticket resale with the transport service provider in question to get access to any data available through the Maritime MaaS API

    At this point, you can see the transport service providers integrated to the API together with their ticket products here.

    The transport service providers choose the tickets they make available via the API themselves. You may always be in contact with the transport service providers to suggest new ticket products you would be interested in.

  3. Please contact the transport service provider to agree on the resale of their ticket products

    While discussing the resale, please address also these topics:
    - Resale commission
    - Customer service responsibilities
    - The account of sold tickets to service provider

  4. When you have signed the agreement on resale of the ticket products, please follow the steps described below:

    1. Send us an email using the address: see up-to-date contact information here

    2. To the topic field, add the name of your company and the label Request for integration (e.g. Forum Virium Helsinki/ Request for integration)

    3. Tell us in the email, that your company has signed an agreement with a transport service provider X (name the company and also give the name of your contact person) and that you would wish to proceed with the integration to the Maritime MaaS API

    4. Send this email to the support-address given above and as visible copy (cc:) to the person you named as your contact person at the transport service provider’s end

    5. We will validate the status of your agreement with the transport service provider and instruct after that you through the integration process.

Regarding any questions related to usage of the API or technical implementation, please contact us by sending email to: see up-to-date contact information here

Vesiliikenteen MaaS -hanke - Maritime MaaS project
Marite MaaS API documentation 2021-2022
Forum Virium Helsinki & City of Helsinki