Skip to content
API showdown/Train Travel API/
/Trips

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.

Security
OAuth2(Required scopes: read)
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?origin=efdbb9d1-02c2-4bc3-afb7-6788d8782b1e&destination=b2e783e1-c824-4d63-b37a-d8d698862f1d&date=2024-02-01T09%3A00%3A00Z&bicycles=false&dogs=false' \
  -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(Trip)

The wrapper for a collection is an array of objects.

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"
  }
}