API

Sections

Theme switcher

/reservations/create

This endpoint can be used to place a reservation in carrier system.

For details about how this endpoint fits into the flow, check the Creating Reservation 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.

Body 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.

return_departure_timestring

Set the departure date and time for the return leg of the trip. Use the value retrieved from the selected trip from the /connections/find response. Reference value: 2024-04-26T06:22.

return_arrival_timestring

Set the arrival date and time for the return leg of the trip. Use the value retrieved from the selected trip from the /connections/find response. Reference value: 2024-04-26T10:34.

retailer_partner_numberstring

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

fare_classstring Required

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.

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.

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.

passengersarray

For multiple passengers, add additional entries of the same entity.

Show child attributes

ancillariesarray

To be used only when ancillaries are required as part of the reservation, and when they apply at booking level. The list of ancillaries available are displayed in the response from the /connections/vacancy endpoint. This feature is only available for certain carriers.

Show child attributes

cardsarray

To be used only when discount cards are applied as part of the reservation, and when they apply at booking level. The card details are displayed in the response from the /cards endpoint, but must be applied in the /connections/find request beforehand. This feature is only available for certain carriers.

Show child attributes

Response

200 (reservation created)
Object
Successful response with reservation created

Response Attributes

dataobject

Show child attributes

jsonapiobject

Show child attributes

metaobject

Show child attributes

includedarray

Show child attributes

400 (departure in past)
Object
Error response: departure time/date set in the past

Response Attributes

errorsarray

Show child attributes

jsonapiobject

Show child attributes

500 (not vacant)
Object
Error response: booking not vacant

Response Attributes

errorsarray

Show child attributes

jsonapiobject

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

POST

/

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