RailSearch request message

Tabular overview of all nodes, which may occur in this message. See legend below for description of table columns.
Note: Some sibling elements or complete sub-trees of the hierarchy may be defined as mutually exclusive alternative choices. This information cannot be expressed in this tabular overview. Please refer to schema diagram for a graphical representation of the message schema.

NodeDescriptionValuesOccursExample
<RailSearchRQ>
Rail search request root element1
@ShowBookableOnly
If Y only offers are returned, which can be booked online.
If N all offers are returned including the ones, which can not be booked online.

Default: N
[Y] [N] 0..1
@PreferFastConnections
Prefer fast connections against cheaper ones.

Default: N
[Y] [N] 0..1
@version
Version number. 0..1 1.0
@Source
Identifies the source of this element. In other words where the content originates from. Not limited to GDS, applicable to direct connect as well. 0..1 1A, 1V, or other.
<Traveler>
For DB maximum number of travelers is 5.1..N
@Type
Passenger type requested for pricing. If the passenger type sent to the GDS is not in the below predefined list, then it is passed as is to the GDS.
Predefined values are :
ADT= Adult
CHD = Child
INF = Infant

1 CHD
<Discount>
A discount to be applied for this Traveler.0..1
@Type
The type of discount to be applied for the Traveler.

[AmtrakAAA] [AmtrakCorporate] [AmtrakIntlStudentID] [AmtrakNatAssocRailPax] [AmtrakStudentAdvantage] [AmtrakUSArmedForces] [AmtrakVeteranAdvantage] [AtocUKAnnualGold] [AtocUKChildDisability] [AtocUKDisability] [AtocUKFamilyFriends] [AtocUKGroupsave3] [AtocUKGroupsave4] [AtocUKHMArmedForces] [AtocUKJobcentrePlus] [AtocUKNetwork] [AtocUKSenior] [AtocUKTwoTogether] [AtocUKYouth] [BahnCard1st25] [BahnCard2nd25] [BahnCard1st50] [BahnCard2nd50] [BahnCardBusiness1st25] [BahnCardBusiness2nd25] [BahnCardBusiness1st50] [BahnCardBusiness2nd50] [A-VORTEILScardInclRAILPLUS] [CH-HalbtaxAboInclRAILPLUS] [CH-HalbtaxAbo] [NL-VoordeelurenaboInclRAILPLUS] [NL-Voordeelurenabo] [RAILPLUS] [DBCorporate] [EurostarCorporate] [RenfeCarnetGo25ISTC] [RenfeCarnetJoven] [RenfeCorporate] [RenfeTarjetaDorada] [RenfeTarjetaJovenRenfe] [RenfeTarjetaRailPlusJunior] [ThalysCorporate] [VIACorporate] 1 BahnCard2nd25
</Discount>
</Traveler>
<OriginDestination>
Origin and destination group

DB (via BIBE) only supports 1 OriginDestination element.
1..N
<Departure>
Origin group1
<StationCode/>
Railway, point of interest, address or other station code.1
</Departure>
<StopOver>
DB supports max 2 stopovers per OriginDestination0..N
<StationCode/>
Railway, point of interest, address or other station code.1
<StopTime/>
Available time at the stop location before following train leaves.
format (hh:mm).
0..1 00:45
</StopOver>
<Arrival>
Destination group1
<StationCode/>
Railway, point of interest, address or other station code.1
</Arrival>
<Date>
Specifies departure date in ISO 8601 format (yyyy-mm-dd). 1 2001-12-25
@Qualifier
attribute indicates qualifier of time (for date, time and timewindow).
Specifies whether the given date is supposed to be ARRIVAL or DEPARTURE date.
[DEPARTURE] [ARRIVAL] 0..1 DEPARTURE
</Date>
<ClassOfService/>
For DB:
1...first class
2...second class
1
<Preferences>
Preferences group0..1
<Time/>
Time in ISO 8601 twenty-four hour clock format (hh:mm). 1 14:25
<TimeWindow>
Time window group0..1
<HoursBefore/>
Number of hours before departure, or arrival, depending on value of Sort attribute. Value from 1 to 12. [1] to [12]0..1 6
<HoursAfter/>
Number of hours after departure, or arrival, depending on value of Sort attribute. Value from 1 to 12. [1] to [12]0..1 12
</TimeWindow>
<MinTransferDuration/>
Minimum available time between two connections.
format (hh:mm).
If nothing specified standard transfer durations are selected.

0..1 01:25
<ConnectionType/>
[direct] [directCouchette] [directSleeper] [admitChanges] 0..1
<MeansOfTransport>
0..1
@Tram
Streetcar, Cablecar, Strassenbahn

Supported by: DB
[Y] [N] 0..1
@Taxi
Taxi, Dial-a-ride (Sammeltaxi)

Supported by: DB
[Y] [N] 0..1
@Bus
Supported by: DB[Y] [N] 0..1
@Urban
Urban trains
e.g. S-Bahn

Supported by: DB
[Y] [N] 0..1
@Subway
Underground trains.
Supported by: DB
[Y] [N] 0..1
@Boat
Supported by: DB[Y] [N] 0..1
@Regional
Regional trains

Supported by: DB
[Y] [N] 0..1
@Interregio
Interregional trains

Supported by: DB
[Y] [N] 0..1
@ICEC
Intercity and Eurocity trains

Supported by: DB
[Y] [N] 0..1
@ICE
IntercityExpress trains

Supported by: DB
[Y] [N] 0..1
</MeansOfTransport>
<TransferToFirstSegment>
If the initial locaion specified as Departure/StationCode does not acutually refer to a station but a different type of location, use TransferToFirstSegment to specify preferences for the transfer from the initial location to the begin of the first segment.0..1
@MeansOfTransfer
Specify accepted means of transfer from the initial location to the begin of the first segment.

Values:
FOOT (default if left out)
FOOT_OR_BICYCLE
FOOT_OR_CAR
FOOT_OR_TAXI

[FOOT] [FOOT_OR_BICYCLE] [FOOT_OR_CAR] [FOOT_OR_TAXI] 0..1 FOOT_OR_CAR
</TransferToFirstSegment>
<TransferFromLastSegment>
If the final locaion specified as Arrival/StationCode does not acutually refer to a station but a different type of location, use TransferFromLastSegment to specify preferences for the transfer from the last segment to the final location.0..1
@MeansOfTransfer
Specify accepted means of transfer from the last segment to the final location.

Values:
FOOT (default if left out)
FOOT_OR_BICYCLE
FOOT_OR_CAR
FOOT_OR_TAXI

[FOOT] [FOOT_OR_BICYCLE] [FOOT_OR_CAR] [FOOT_OR_TAXI] 0..1 FOOT_OR_CAR
</TransferFromLastSegment>
</Preferences>
</OriginDestination>
</RailSearchRQ>

Legend

ColumnDescription
NodeName of message node (element or attribute). Nodes in bold type are mandatory, if their parent element occurs in the message. Point mouse cursor at table cell to view complete XPath.
DescriptionDescription of meaning and usage of the node.
ValuesList of predefined values (each in square brackets) or range of values ("[a] to [z]") allowed for the node, if formally defined in the schema.
OccursMinimum and maximum number of times the node must/may occur, if its parent element occurs in the message. Examples:
0..3 Node is optional and may occur up to 3 times.
1..N Node must occur at least one (mandatory) and may occur any number of times.
2 Node must occur exactly twice.
ExampleExample value for the node.

XML Schema documentation generated with XX/1 server