# Train Travel API

API for finding and booking train trips across Europe.

This API was created by [Bump.sh](https://bump.sh/) for the entire OpenAPI
community, for educational and demonstrative purposes.


Version: 1.0.0
License: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International

## Servers

Production
```
https://api.example.com
```

## Security

### OAuth2

OAuth 2.0 authorization code following RFC8725 best practices.

Type: oauth2

## Download OpenAPI description

[Train Travel API](https://innovario.apishowdown.com/_spec/catalog/api-showdown/api-hub/Train%20Travel/openapi.yaml)

## Stations

Find and filter train stations across Europe, including their location
and local timezone.


### Get a list of train stations

 - [GET /stations](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/stations/get-stations.md): Returns a list of all train stations in the system.

## Trips

Timetables and routes for train trips between stations, including pricing
and availability.


### Get available train trips

 - [GET /trips](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/trips/get-trips.md): Returns a list of available train trips between the specified origin and destination stations on the given date, and allows for filtering by bicycle and dog allowances.

## Bookings

Create and manage bookings for train trips, including passenger details
and optional extras.


### List existing bookings

 - [GET /bookings](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/bookings/get-bookings.md): Returns a list of all trip bookings by the authenticated user.

### Create a booking

 - [POST /bookings](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/bookings/create-booking.md): A booking is a temporary hold on a trip. It is not confirmed until the payment is processed.

### Get a booking

 - [GET /bookings/{bookingId}](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/bookings/get-booking.md): Returns the details of a specific booking.

### Delete a booking

 - [DELETE /bookings/{bookingId}](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/bookings/delete-booking.md): Deletes a booking, cancelling the hold on the trip.

### New Booking

 - [POST newBooking](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/bookings/new-booking.md): Subscribe to new bookings being created, to update integrations for your users.  Related data is available via the links provided in the request.


## Payments

Pay for bookings using a card or bank account, and view payment
status and history.

> warn
> Bookings usually expire within 1 hour so you'll need to make your payment
> before the expiry date 


### Pay for a Booking

 - [POST /bookings/{bookingId}/payment](https://innovario.apishowdown.com/catalog/api-showdown/api-hub/train-travel/openapi/payments/create-booking-payment.md): A payment is an attempt to pay for the booking, which will confirm the booking for the user and enable them to get their tickets.