API

Sections

Theme switcher

/connections/seats

This endpoint can be used to retrieve the seat layout of the bus for the requested trip. It will return all the information required for you to display the available seats to your user and allow a free seat to be selected, such as the seat label, vacancy status, fare class, and postition coordinates (x - row, y - column, z - level).

For details about how this endpoint fits into the flow, check the Selecting Seats step.

Header Parameters

api-keystring

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

Query Parameters

marketing_carrierstring Required

Set the carrier code. Use the value retrieved from the selected trip from the /connections/find response. Reference value: AMTR.

departure_stationstring Required

Set the departure station code. Use the value retrieved from the selected trip from the /connections/find response. Reference value: FRPARPGB.

arrival_stationstring Required

Set the arrival station code. Use the value retrieved from the selected trip from the /connections/find response. Reference value: DEBERCBS.

departure_timestring Required

Set the departure date and time. Use the value retrieved from the selected trip from the /connections/find response. Reference value: 2024-04-25T06:58.

arrival_timestring Required

Set the arrival date and time. Use the value retrieved from the selected trip from the /connections/find response. Reference value: 2024-04-25T08:30.

retailer_partner_numberstring

Set the retailer partner number (RPN). Contact your partnership manager to receive yours. Reference value: 012345.

currencystring

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.

fare_classstring

Set the fare class. Use the value retrieved from the selected trip from the /connections/find response. Default set to FARE-1 if the field is not used. Reference value: FARE-1.

passengers[][pax]string

Set the number of passengers of a certain type. Carrier passenger types and age definitions can be found in the /marketing_carriers/{marketing_carrier_id} endpoint or the /connections/find endpoint. Reference value: 1.

passengers[][type]string

Set the type of passenger. Carrier passenger types and age definitions can be found in /marketing_carriers/{marketing_carrier_id} endpoint or /connections/find endpoint. For more details check our Passenger Types guide. Reference value: PNOS.

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: CartaFRECCIAXGO.

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: 121829048.

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: CartaFRECCIAXGO.

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: 121829048.

Response

200 (seat details)
Object
Successful response with seat map details

Response Attributes

dataarray

Show child attributes

jsonapiobject

Show child attributes

includedarray

Show child attributes

200 (Trenitalia seat details)
Object

Response Attributes

dataarray

Show child attributes

jsonapiobject

Show child attributes

includedarray

Show child attributes

400 (seats not supported)
Object
Error response: seats not supported by carrier

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