Cart
Cart is empty

Technical guide for API integration

Integration model

RegioJet offers its REST API to partners where they can call search and booking endpoints. Business model of cooperation is based on commission fee. The following tutorial shows how to integrate your system to us.

API Documentation

Booking API

The integration process is simple and consists from 8 main steps:

  1. Load constants GET /consts/tariffs, /consts/seatClasses, /consts/tariffs, /consts/locations, /consts/translations/{language}.
  2. Call GET /routes/search simple to search routes only.
  3. Call GET /routes/{routeId}/simple that returns detail of the route, especially part of route and seatClass.
  4. Call POST /routes/{routeId}/freeSeats. You need routeId and part of route from step 2 and 3; returns selectedSeats.
  5. Call POST /routes/{routeId}/passengesData. You need routeId and seatClass from step 2 and 3; returns mandatory data to make reservation.
  6. Create new ticket for new account as affiliate partner with POST /tickets/create/affiliate.
  7. Confirm payment PUT /payments/{ticketId}/pay.
  8. Print ticket GET /tickets/{ticketId}. You need a GET /users/authenticate endpoint to obtain an accountCode, an essential part of the ticket.
  9. The cancelation endpoint is optional. Average response of search API is around 100–300ms.

The booking schema below describes whole process

Communication

Join us at studentagencygroup.slack.com and be in touch with our API team.

How to start

  1. Review our API documentation.
  2. Contact us at partners@regiojet.cz.
  3. Receive access to QA environment and Slack.
  4. Agree on contract.
  5. Integrate and Test.
  6. Get production access and go live.

Whole integration process takes from 3–4 weeks in average.

API landscape

Development and testing environments are available at:

API status

Realtime monitoring and maintenance status is available online. Subscribe at http://status.regiojet.com.

Ready to test

You've successfully integrated our API and it's time to test it!

Please try following testing scenarios on QA environment and then send us accountCodes or tickedIDs (of created tickets during testing) and we will check them.

  • Brno–Prague, TRAIN, any date, any time, ticket for 1 passenger, tariff regular, priceClass standard (no transfer)
  • Brno–Prague, BUS, any date, any time, ticket for 1 passenger, tariff child 6-18 (no transfer)
  • Brno–Liberec, TRAIN + BUS combination, any date, any time, ticket for 1 passenger, tariff child 6-18 (1 transfer)
  • Karlovy Vary – Liberec, BUS + BUS combination, any date, any time, ticket for 1 passenger, tariff child 6-18 (1 transfer)
  • Support connection, BUS, any date, any time, ticket for 1 passenger, tariff regular (no transfer)
    • We will create support bus connection on request

When you create all tickets mentioned above send them to us and we will check them in our system. After successful checking there will be one last thing to try – ticket cancellation. You will have to cancel four tickets (two domestic and two international), we will then check them on our side again. If no problems arise you have successfully pass our tests.