API

Sections

Theme switcher

/connections/find

Find connections between departure/arrival stations on a specific date.

For details about how this endpoint fits into the flow, check the Searching for Trips step.

Header Parameters

api-keystring Required

Set your API key. To request a demo API key please reach out to us at partner@distribusion.com. Reference value: ZW8FXhnBl53yTkrMvoqLp4Xq7mf9nEBGsxpTWrid.

Query Parameters

localestring Required

Set the language for the content of the response. The field accepts ISO 639 language codes. If the content in the specified language is unavailable, English will be returned. For more details check our Languages guide. Reference value: en.

currencystring Required

Set the currency of all monetary results in the response. The field accepts ISO 4217 currency codes. For more details check our Currencies guide. Reference value: EUR.

departure_stations[]string

Search from a specific departure station. Full list of stations available under /stations endpoint. Reference value: FRPARPGB.

departure_citystring

Search from specific departure city. Sample value DEBER. Full list of cities available under /citites endpoint.

departure_areastring

Search from a specific departure area. Areas can be Airports or Superstations. Full list of areas available under /areas endpoint. Reference value: DEAUGAC.

arrival_stations[]string

Search from a specific arrival station. Full list of stations available under /stations endpoint. Reference value: DEBERCBS.

arrival_citystring

Search from a specific arrival city. Full list of cities available under /cities endpoint. Reference value: ESBCN.

arrival_areastring

Search from a specific arrival area. Areas can be airports or superstations. Full list of areas available under /areas endpoint. Reference value: FRBIQBA.

departure_datestring Required

Set the date of departure. Sample value 2024-01-31.

departure_start_timestring

Set the departure start time to search from. Reference value: 10:00.

departure_end_timestring

Set the departure end time to search to. Reference value: 19:00.

return_datestring

Set the date of return for return trips. If not entered, a one-way search will be performed. Reference value: 2024-02-31.

return_start_timestring

Set the departure start time to search from related to the return leg of the trip. Reference value: 10:00.

return_end_timestring

Set the departure end time to search to related to the return leg of the trip. Reference value: 19:00.

paxstring

Set the number of passengers (integer in a range of 1 - 30). Shouldn't be used in combination with "passengers[][pax]" or "passengers[][max_age]". Reference value: 1.

passengers[][pax]string Required

Set the number of passengers in a group of the same type. To be used in combination with "passengers[][max_age]". Reference value: 1.

passengers[][max_age]string Required

Set the max age of passengers in a group of the same type. To be used in combination with "passengers[][pax]". Reference value: 25.

booking_idstring

Set the booking ID for amending a previously created booking. For more details check our Amendments guide. Reference value: EyfvbaiaOc5SwbyBT7Nl-A.

passengers[][cards][][name]string

Set the name for the discount card, loyalty card, or voucher. Valid for cards that apply at passenger level. For more details check our Discount Cards guide. Reference value: ADVANTAGE_LIBERTE_STES.

passengers[][cards][][code]string

Set the code for the discount card, loyalty card, or voucher. Valid for cards that apply at passenger level. For more details check our Discount Cards guide. Reference value: 29090115729137964.

cards[][name]string

Set the name for the discount card, loyalty card, or voucher. Valid for cards that apply at booking level. For more details check our Discount Cards guide. Reference value: CLUB_EUROSTAR.

cards[][code]string

Set the code for the discount card, loyalty card, or voucher. Valid for cards that apply at booking level. For more details check our Discount Cards guide. Reference value: C002Z98.

multiple_legsstring

Activate results for carriers that allow virtual interlining for supported retailer accounts. For more details check our Virtual Interlining guide. Reference value: true.

collect_withinstring

Set the timeout for the response (in milliseconds). Reference value: 10000.

carrier_codes[]string

Filter the results to trips from a specific carrier. Reference value: RENF.

departure[type]string

Set the type of search. Departure types available: geo, iata, uic. Reference value: geo.

departure[value]string

For geo search: Set the latitude and longitude coordinates (decimal degrees) representing the departure point. Requires exactly 6 decimal places. Reference value: 51.513150,-0.170650.

For IATA search: Set the 3-letter IATA airport code. Reference value: BER.

For UIC search: Set the 7-digit codes typically used for train stations. Reference value: 8065969.

departure[radius]string

For geo search only: Set the radius (in meters) around the departure location to search for stations when using geo search. Max 20000 meters (20 km) and min 10 meters. Reference value: 1000.

arrival[type]string

Set the type of search. Arrival types available: geo, iata, uic. Reference value: geo.

arrival[value]string

For geo search: Set the latitude and longitude coordinates (decimal degrees) representing the arrival point. Requires exactly 6 decimal places. Reference value: 51.513150,-0.170650.

For IATA search: Set the 3-letter IATA airport code. Reference value: BER.

For UIC search: Set the 7-digit codes typically used for train stations. Reference value: 8065969.

arrival[radius]string

For geo search only: Set the radius (in meters) around the arrival location to search for stations when using geo search. Max 2000 meters (2 km) and min 10 meters. Reference value: 1000.

Response

200 (with trip results)
Object
Successful response with trip results

Response Attributes

dataarray

Show child attributes

includedarray

Show child attributes

jsonapiobject

Show child attributes

metaobject

Show child attributes

200 (no trip results)
Object
Successful response with no trip results

Response Attributes

dataarray
includedarray
jsonapiobject

Show child attributes

metaobject

Show child attributes

400 (depart location missing)
Object
Error response: departure station, area or city missing

Response Attributes

errorsarray

Show child attributes

jsonapiobject

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

GET

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot