API showdown
/
Train Travel API
/
Train Travel
/
Trips
/
Get available train trips

Train Travel API (1.0.0)

API for finding and booking train trips across Europe.

This API was created by Bump.sh for the entire OpenAPI community, for educational and demonstrative purposes.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL

https://example.com/support

Train Support

support@example.com

License

CC-BY-NC-SA-4.0

Languages
Servers
Mock server

https://innovario.apishowdown.com/_mock/catalog/api-showdown/api-hub/train-travel/openapi/

Production

https://api.example.com/

Stations

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

Operations

Trips

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

Operations

Get available train trips

Request

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.

Query
originstring(uuid)required

The ID of the origin station

Example: origin=efdbb9d1-02c2-4bc3-afb7-6788d8782b1e
destinationstring(uuid)required

The ID of the destination station

Example: destination=b2e783e1-c824-4d63-b37a-d8d698862f1d
datestring(date-time)required

The date and time of the trip in ISO 8601 format in origin station's timezone.

Example: date=2024-02-01T09:00:00Z
bicyclesboolean

Only return trips where bicycles are known to be allowed

Default false
dogsboolean

Only return trips where dogs are known to be allowed

Default false
curl -i -X GET \
  'https://innovario.apishowdown.com/_mock/catalog/api-showdown/api-hub/train-travel/openapi/trips?bicycles=false&date=2024-02-01T09%3A00%3A00Z&destination=b2e783e1-c824-4d63-b37a-d8d698862f1d&dogs=false&origin=efdbb9d1-02c2-4bc3-afb7-6788d8782b1e' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

A list of available train trips

Headers
RateLimitstring

The RateLimit header communicates quota policies. It contains a limit to convey the expiring limit, remaining to convey the remaining quota units, and reset to convey the time window reset time.

Body
dataArray of objects

The wrapper for a collection is an array of objects.

linksobjectread-only

A set of hypermedia links which serve as controls for the client.

Response
{
  "data": [
    { … },
    { … }
  ],
  "links": {
    "self": "https://api.example.com/trips?origin=efdbb9d1-02c2-4bc3-afb7-6788d8782b1e&destination=b2e783e1-c824-4d63-b37a-d8d698862f1d&date=2024-02-01",
    "next": "https://api.example.com/trips?origin=efdbb9d1-02c2-4bc3-afb7-6788d8782b1e&destination=b2e783e1-c824-4d63-b37a-d8d698862f1d&date=2024-02-01&page=2"
  }
}

Bookings

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

OperationsWebhooks

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

Operations