Partial Integration

departureCity, departureArea, or departureStation

Departure point. Choose one of the options. E.g., DEBER

Mandatory - String

arrivalCity, arrivalArea, or arrivalStation

Arrival point. Choose one of the options. E.g., GBLON

Mandatory - String

retailerPartnerNumber

Your Distribusion account number (6 digits).

Mandatory - Integer

marketingCarrierCode

Filter the list of carriers to return in the search results.

Optional - String

returnMarketingCarrier

Return trip marketing carrier code. E.g., ?returnMarketingCarrier=FLXB

Optional - String

trainType

Train type filter code. E.g., ?trainType=ICE

Optional - String

departureDate

Departure date for the trip in ISO 8601 format YYYY-MM-DD. Defaults to today. Past dates are automatically adjusted to today.

Optional - String

departureTime

Outbound departure time (HH:mm, 24h). E.g., ?departureTime=08:30

Optional - String

departureEndTime

Latest outbound departure time (HH:mm, 24h). E.g., ?departureEndTime=20:00

Optional - String

arrivalDate

Outbound arrival date (YYYY-MM-DD). E.g., ?arrivalDate=2025-12-10

Optional - String

arrivalTime

Outbound arrival time (HH:mm, 24h). E.g., ?arrivalTime=12:00

Optional - String

returnDate

Return date for the trip in ISO 8601 format YYYY-MM-DD. If set before departureDate, it is automatically adjusted.

Optional - String

returnDepartureDate

Return trip departure date (YYYY-MM-DD). E.g., ?returnDepartureDate=2025-12-15

Optional - String

returnDepartureTime

Return trip departure time (HH:mm, 24h). E.g., ?returnDepartureTime=09:00

Optional - String

returnArrivalDate

Return trip arrival date (YYYY-MM-DD). E.g., ?returnArrivalDate=2025-12-15

Optional - String

returnArrivalTime

Return trip arrival time (HH:mm, 24h). E.g., ?returnArrivalTime=13:00

Optional - String

returnStartTime

Earliest return departure time (HH:mm, 24h). E.g., ?returnStartTime=07:00

Optional - String

returnEndTime

Latest return departure time (HH:mm, 24h). E.g., ?returnEndTime=18:00

Optional - String

pax

Number of passengers. E.g., ?pax=2

Optional - Integer

passengers[][type]

Passenger type code. E.g., &passengers[0][type]=PNOS

Optional - String

passengers[][pax]

Number of passengers of this type. E.g., &passengers[0][pax]=1

Optional - Integer

passengers[][max_age]

The maximum age in the group of passengers. E.g., &passengers[0][maxAge]=120

Optional - Integer

cards

Discount cards (array). E.g., ?cards[0][name]=Name&cards[0][code]=1234

Optional - String

passengersCards

Cards per passenger (JSON or URL-encoded string). E.g., ?passengersCards=%5B%22bahncard25%22%5D

Optional - String

fareClass

Outbound fare class code. E.g., ?fareClass=ECONOMY

Optional - String

returnFareClass

Return fare class code. E.g., ?returnFareClass=BUSINESS

Optional - String

price

Maximum price filter. E.g., ?price=100

Optional - Float

travelClass

Travel class code. E.g., ?travelClass=FIRST

Optional - String

sorting

Sorting method. Accepted values: price, duration, departure_time, arrival_time, transfers. E.g., ?sorting=price

Optional - String

fastestConnections

Only show fastest connections (true/false). E.g., ?fastestConnections=true

Optional - Boolean

express

Express search mode — automatically finds available trips (true/false). E.g., ?express=true

Optional - Boolean

shouldFindAvailableTrips

Only show available trips (true/false). E.g., ?shouldFindAvailableTrips=true

Optional - Boolean

minTransferTime

Minimum transfer time in minutes. E.g., ?minTransferTime=10

Optional - Integer

stopOverStations

Stopover station codes (array). E.g., ?stopOverStations[0]=GBLONFRO&stopOverStations[1]=GBLONALO

Optional - String

stopOverStationsOutbound

Outbound stopover station codes (array). E.g., ?stopOverStationsOutbound[0]=GBLONFRO

Optional - String

stopOverStationsInbound

Inbound stopover station codes (array). E.g., ?stopOverStationsInbound[0]=GBLONFRO

Optional - String

viasRules

Via inclusion/exclusion rules (JSON or URL-encoded). Keys are station codes, values are include or exclude. E.g., ?viasRules=%7B%22STAT1%22%3A%22include%22%7D

Optional - String

viasRulesOutbound

Via rules for outbound leg (same format as viasRules).

Optional - String

viasRulesInbound

Via rules for inbound leg (same format as viasRules).

Optional - String

viasDwellTimes

Dwell times at via stations in minutes (JSON or URL-encoded). Keys are station codes, values are minutes. E.g., ?viasDwellTimes=%7B%22STAT1%22%3A10%7D

Optional - String

viasDwellTimesOutbound

Dwell times for outbound vias (same format as viasDwellTimes).

Optional - String

viasDwellTimesInbound

Dwell times for inbound vias (same format as viasDwellTimes).

Optional - String

mode

Display mode for the booking engine UI. Accepted values: page (default, standalone page), embed (embedded in an iframe or external site), app (mobile app webview). E.g., ?mode=embed

Optional - String

locale

Language code for the UI. A two-letter or four-letter code is accepted, like en or en-US.

Optional - String

currency

Currency code for the UI. Three-letter ISO currency code, like EUR or USD.

Optional - String

tz

Timezone in IANA format. E.g., ?tz=Europe%2FBerlin

Optional - String

hideLocations

Hide location selection in the UI (true/false). E.g., ?hideLocations=true

Optional - Boolean

hideTicketDetails

Hide ticket details in the UI (true/false). E.g., ?hideTicketDetails=true

Optional - Boolean

timetable

Display results in timetable view (true/false). E.g., ?timetable=true

Optional - Boolean

weekly

Enable weekly trip search mode (true/false). E.g., ?weekly=true

Optional - Boolean

seatProduct

Enable seat reservation mode (true/false). E.g., ?seatProduct=true

Optional - Boolean

seats

Pre-selected seat assignments (JSON or URL-encoded object). Structured as a nested object keyed by connection type (outbound/inbound) and segment. E.g., ?seats=%7B%22outbound%22%3A%7B%7D%7D

Optional - String

offerIds

Offer IDs (arra). E.g., ?offerIds[0]=123&offerIds[1]=456

Optional - String

inExp

Experiment identifier. Used to assign the user to a specific A/B test experiment. E.g., ?inExp=42

Optional - Integer

bookingId

Booking identifier. E.g., ?bookingId=BOOK123

Optional - String

retailerBookingNumber

Retailer booking reference. E.g., ?retailerBookingNumber=ABC123

Optional - String

email

Pre-filled customer email address. E.g., ?email=test%40example.com

Optional - String

phone

Pre-filled customer phone number. E.g., ?phone=49123456789

Optional - String

seasonTicket

Enable season ticket search mode (true/false). E.g., ?seasonTicket=true

Optional - Boolean

parentDomain

Parent domain for embed mode. Used for postMessage communication between the iframe and the host page. E.g., ?parentDomain=example.com

Optional - String

retailerReturnUrl

URL to redirect the user to after booking. Must be a valid http:// or https:// URL. E.g., ?retailerReturnUrl=https%3A%2F%2Fexample.com%2Freturn

Optional - String

seo

SEO pre-rendering mode (true/false). Typically set automatically during server-side rendering. E.g., ?seo=true

Optional - Boolean