Breadcrumb
- Booking Management API User Guide
- Create Booking
- Create Booking - Examples
Create Booking - Examples
Below are some common use cases related to booking creation:
Create an NDC booking (order)
To ensure a successful booking, pass a valid offerID
, selectedOfferItems
, and the traveler id
returned by the Offer Price API.
"flightOffer": {
"offerId": "{{price_offer_id}}",
"selectedOfferItems": [
"{{price_offer_item_id}}"
]
},
"travelers": [
{
"id": "{{price_passenger_id}}",
"givenName": "John",
"surname": "Kowalski",
"birthDate": "1970-01-23",
"passengerCode": "ADT"
}
],
"contactInfo":
{
"emails": [
"travel@sabre.com"
],
"phones": [
"123456"
]
}
}
Create an NDC booking (order) and use profile information to populate traveler data
To ensure a successful booking, the traveler profile must contain the traveler's first name, surname, passenger type, and birth date:
"profiles": [
{
"profileName": "TESTPROFILE",
"profileTypeCode": "TVL",
"domainId": "G7RE"
}
],
"flightOffer": {
"offerId": "{{price_offer_id}}",
"selectedOfferItems": [
"{{price_offer_item_id}}"
]
},
"travelers": [
{
"id": "{{price_passenger_id}}"
}
]
}
Create an NDC booking (order) for multiple travelers (identity documents and loyalty programs included)
To ensure a successful booking, pass a valid offerID
, selectedOfferItems
, and the traveler id
returned by the Offer Price API.
"flightOffer": {
"offerId": "{{price_offer_id}}",
"selectedOfferItems": [
"{{price_offer_item_id}}"
]
},
"travelers": [
{
"id": "{{price_passenger_id1}}",
"givenName": "John",
"surname": "Smith",
"birthDate": "1970-01-23",
"passengerCode": "ADT",
"age": 53,
"phones": [
{
"number": "678999",
"label": "M"
}
],
"emailAddresses": [
{
"address": "john@travel.com"
}
],
"loyaltyPrograms": [
{
"supplierCode": "AA",
"programType": "FREQUENT_FLYER",
"programNumber": "{{AA_program_number_1}}",
"tierLevel": 3,
"receiverCode": "AA"
}
],
"identityDocuments": [
{
"documentNumber": "{{document_number_1}}",
"documentType": "PASSPORT",
"expiryDate": "2024-07-09",
"issuingCountryCode": "US",
"residenceCountryCode": "DE",
"givenName": "John",
"surname": "Smith",
"birthDate": "1970-01-23",
"gender": "MALE"
}
]
},
{
"id": "{{price_passenger_id2}}",
"givenName": "Jill",
"surname": "Smith",
"birthDate": "1971-02-23",
"passengerCode": "ADT",
"age": 52,
"loyaltyPrograms": [
{
"supplierCode": "AA",
"programType": "FREQUENT_FLYER",
"programNumber": "{{AA_program_number_1}}",
"tierLevel": 3,
"receiverCode": "AA"
}
]
},
{
"id": "{{price_passenger_id3}}",
"givenName": "Jack",
"surname": "Smith",
"birthDate": "1972-03-23",
"passengerCode": "ADT",
"age": 51,
"emailAddresses": [
{
"address": "jack@travel.com"
}
],
"identityDocuments": [
{
"documentNumber": "{{document_number_2}}",
"documentType": "VISA",
"hostCountryCode": "US",
"residenceCountryCode": "DE",
"placeOfBirth": "NYC",
"birthDate": "1972-03-23",
"placeOfIssue": "DE",
"issueDate": "2021-12-02",
"expiryDate": "2050-07-09",
"gender": "UNDEFINED",
"givenName": "Jack",
"surname": "Smith"
}
]
}
],
"contactInfo": {
"emails": [
"travel@sabre.com"
],
"phones": [
"123456"
]
}
}
Create an ATPCO booking (PNR) and use profile information to populate traveler data
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
},
"ticketingPolicy": "TODAY"
},
"profiles": [
{
"uniqueId": "228159893",
"profileTypeCode": "TVL",
"domainId": "G7RE"
}
],
"flightDetails": {
"flights": [
{
"flightNumber": 463,
"airlineCode": "EY",
"fromAirportCode": "MEL",
"toAirportCode": "AUH",
"departureDate": "2021-03-30",
"departureTime": "16:55",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
},
{
"flightNumber": 462,
"airlineCode": "EY",
"fromAirportCode": "AUH",
"toAirportCode": "MEL",
"departureDate": "2021-04-15",
"departureTime": "09:00",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
}
]
}
}
Create an ATPCO booking (PNR) with an additional request to price the reservation
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
}
},
"travelers": [
{
"givenName": "John",
"surname": "Kowalski",
"birthDate": "1970-01-23",
"passengerCode": "ADT"
},
{
"givenName": "Little",
"surname": "Kowalski",
"birthDate": "2021-01-23",
"passengerCode": "INF"
}
],
"contactInfo":
{
"emails": [
"travel@sabre.com",
"travel2@sabre.com"
],
"phones": [
"+123456"
]
},
"flightDetails": {
"flights": [
{
"flightNumber": 463,
"airlineCode": "EY",
"fromAirportCode": "MEL",
"toAirportCode": "AUH",
"departureDate": "2021-03-31",
"departureTime": "16:55",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
},
{
"flightNumber": 462,
"airlineCode": "EY",
"fromAirportCode": "AUH",
"toAirportCode": "MEL",
"departureDate": "2021-04-16",
"departureTime": "09:00",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
}
],
"flightPricing": [
{
}
]
}
}
Create an ATPCO booking (PNR) with an additional pricing request
Perform an extra validation of the resulting price against a defined price threshold:
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
},
"agencyCustomerNumber": "1234567",
"ticketingPolicy": "TODAY"
},
"travelers": [
{
"givenName": "John",
"surname": "Smith",
"birthDate": "1970-01-23",
"passengerCode": "ADT"
},
{
"givenName": "Jane",
"surname": "Smith",
"birthDate": "2015-01-23",
"passengerCode": "CNN"
}
],
"contactInfo": {
"emails": [
"travel@sabre.com",
"travel2@sabre.com"
],
"phones": [
"+123456"
]
},
"flightDetails": {
"flights": [
{
"flightNumber": 463,
"airlineCode": "EY",
"fromAirportCode": "MEL",
"toAirportCode": "AUH",
"departureDate": "2021-03-30",
"departureTime": "16:55",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
},
{
"flightNumber": 462,
"airlineCode": "EY",
"fromAirportCode": "AUH",
"toAirportCode": "MEL",
"departureDate": "2021-04-15",
"departureTime": "09:00",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
}
],
"flightPricing": [
{
"priceComparisons": [
{
"desiredAmount": "5300.00",
"comparisonType": "INCREASE_BY_AMOUNT",
"amount": "30.00"
},
{
"desiredAmount": "5300.00",
"comparisonType": "DECREASE_BY_AMOUNT",
"amount": "30.00"
}
]
}
]
}
}
Create an ATPCO booking (PNR) with additional information on traveler documents
Add a request to price the booking using the chosen form of payment:
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
},
"ticketingPolicy": "TODAY"
},
"travelers": [
{
"givenName": "John",
"surname": "Smith",
"birthDate": "1970-01-23",
"passengerCode": "ADT",
"identityDocuments": [
{
"documentNumber": "0123456789",
"documentType": "PASSPORT",
"expiryDate": "2024-07-09",
"issuingCountryCode": "US",
"residenceCountryCode": "US",
"givenName": "John",
"middleName": "Jack",
"surname": "Smith",
"birthDate": "1980-12-02",
"gender": "MALE"
}
]
}
],
"contactInfo":
{
"emails": [
"travel@sabre.com",
"travel2@sabre.com"
],
"phones": [
"+123456"
]
},
"flightDetails": {
"flights": [
{
"flightNumber": 463,
"airlineCode": "EY",
"fromAirportCode": "MEL",
"toAirportCode": "AUH",
"departureDate": "2021-03-30",
"departureTime": "16:55",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
},
{
"flightNumber": 462,
"airlineCode": "EY",
"fromAirportCode": "AUH",
"toAirportCode": "MEL",
"departureDate": "2021-04-15",
"departureTime": "09:00",
"bookingClass": "Y",
"marriageGroup": false,
"flightStatusCode": "NN"
}
],
"flightPricing": [
{
"qualifiers": {
"payment": {
"primaryFormOfPayment": 1
}
}
}
]
},
"payment": {
"billingAddress": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US"
},
"formsOfPayment": [
{
"type": "PAYMENTCARD",
"cardTypeCode": "VI",
"cardNumber": "4005111111111136",
"expiryDate": "2024-07"
}
]
}
}
Create an ATPCO booking (PNR) with an additional request to book ancillary (with mandatory SSR details)
To ensure a successful booking, pass valid ancillary details returned by Get Ancillary Offers. Verify if the airline requires SSR information for the selected ancillary item:
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
},
"agencyCustomerNumber": "1234567",
"ticketingPolicy": "TODAY"
},
"travelers": [
{
"givenName": "John",
"surname": "Smith",
"birthDate": "1970-01-23",
"passengerCode": "ADT",
"specialServices": [
{
"code": "FBAG"
}
],
"ancillaries": [
{
"reasonForIssuance": "BAGGAGE",
"subcode": "0CC",
"airlineCode": "LH",
"electronicMiscellaneousDocumentType": "FLIGHT_COUPON_ASSOCIATED",
"basePrice": "137.00",
"currencyCode": "PLN",
"groupCode": "BG",
"flightIndices": [
1
]
}
]
}
],
"contactInfo": {
"emails": [
"travel@sabre.com"
],
"phones": [
"+123456"
]
},
"flightDetails": {
"flights": [
{
"flightNumber": 809,
"airlineCode": "LH",
"fromAirportCode": "ARN",
"toAirportCode": "FRA",
"departureDate": "2021-11-30",
"departureTime": "06:15",
"bookingClass": "Y",
"flightStatusCode": "NN"
}
],
"flightPricing": [
{}
]
}
}
Create booking for hotel content
To ensure a successful booking, pass valid travelers
information (givenName
, surname
, passengerCode
, (age
if the traveler is a child/infant), agency
address, and bookingKey
returned by Hotel Price Check.
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
},
"agencyCustomerNumber": "1234567",
"ticketingPolicy": "TODAY"
},
"travelers": [
{
"givenName": "John",
"surname": "Kowalski",
"passengerCode": "ADT"
},
{
"givenName": "Junior",
"surname": "Kowalski",
"passengerCode": "INF",
"age": 3
}
],
"contactInfo": {
"emails": [
"travel@sabre.com",
"travel2@sabre.com"
],
"phones": [
"+123456"
]
},
"hotel": {
"bookingKey": "{{bookingKey}}",
"rooms": [
{
"travelerIndices": [
1,
2
]
}
],
"paymentPolicy": "DEPOSIT",
"formOfPayment": 1
},
"payment": {
"formsOfPayment": [
{
"type": "PAYMENTCARD",
"cardTypeCode": "VI",
"cardNumber": "4487971000000006",
"cardSecurityCode": "123",
"expiryDate": "2022-10",
"cardHolder": {
"givenName": "John",
"surname": "Smith",
"email": "john@smith.family.priv",
"phone": "+1-555-123-4567",
"address": {
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US"
}
}
}
]
}
}
Create booking for hotel content with Strong Customer Authentication (SCA) details
To ensure a successful booking, pass valid travelers
information (givenName
, surname
, passengerCode
, (age
if the traveler is a child/infant), agency
address, and bookingKey
returned by Hotel Price Check).
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
},
"agencyCustomerNumber": "1234567",
"ticketingPolicy": "TODAY"
},
"travelers": [
{
"givenName": "John",
"surname": "Kowalski",
"passengerCode": "ADT"
}
],
"contactInfo": {
"emails": [
"travel@sabre.com"
],
"phones": [
"+123456"
]
},
"hotel": {
"bookingKey": "{{bookingKey}}",
"rooms": [
{
"travelerIndices": [
1
]
}
],
"paymentPolicy": "DEPOSIT",
"formOfPayment": 1
},
"payment": {
"formsOfPayment": [
{
"type": "PAYMENTCARD",
"cardTypeCode": "VI",
"cardNumber": "4487971000000006",
"cardSecurityCode": "123",
"expiryDate": "2022-10",
"authentications": [
{
"secureTransactionId": "ABCDEFGHI123456789012!.1234567890123",
"issuesCode": "AO",
"channelCode": "SC",
"resultCode": "OK",
"electronicCommerceIndicator": "AB",
"cardNumberCollectionCode": "K",
"exemptionTypeCode": "EC",
"mandateTypeCode": "NS",
"originalPaymentReference": "1234547839012345",
"merchantName": "TEST CREDIT CARD",
"secureAuthenticationValue": "ABC123455533533444455555678",
"updatedDateTime": "2019-08-19T09:35:10",
"amount": "1234.56",
"currencyCode": "USD",
"tokenAuthenticationValue": "ABC3434334343556677487312567",
"verificationResultCode": "PASS",
"version": 120
}
],
"cardHolder": {
"givenName": "John",
"surname": "Smith",
"email": "john@smith.family.priv",
"phone": "+1-555-123-4567",
"address": {
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US"
}
}
}
]
}
}
Create booking for hotel content and use profile information to populate traveler data
To ensure a successful booking, pass a valid agency
address and bookingKey
returned by Hotel Price Check. The traveler profile must contain the traveler's name, surname, and birth date:
"profiles": [
{
"uniqueId": "231448659",
"profileTypeCode": "TVL",
"domainId": "G7RE"
},
{
"uniqueId": "231448673",
"profileTypeCode": "TVL",
"domainId": "G7RE"
}
],
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
}
},
"hotel": {
"bookingKey": "{{bookingKey}}",
"rooms": [
{
"travelerIndices": [
1,
2
]
}
],
"paymentPolicy": "DEPOSIT",
"formOfPayment": 1
},
"payment": {
"formsOfPayment": [
{
"type": "AGENCY_NAME",
"agencyAddress": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US"
}
}
]
}
}
Create booking for car content
To ensure a successful booking, pass a valid bookingKey
returned by the Vehicle Price Check API.
"agency": {
"address": {
"name": "John Smith",
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US",
"freeText": "John Smith\n1230 Ellen Ave, apt 10\nDallas, TX 75063\nUS"
},
"agencyCustomerNumber": "1234567",
"ticketingPolicy": "TODAY"
},
"travelers": [
{
"givenName": "John",
"surname": "Kowalski",
"passengerCode": "ADT"
}
],
"contactInfo": {
"emails": [
"travel@sabre.com"
],
"phones": [
"+123456"
]
},
"car": {
"bookingKey": "{{carBookingKey}}"
},
"payment": {
"formsOfPayment": [
{
"type": "PAYMENTCARD",
"cardTypeCode": "VI",
"cardNumber": "4487971000000006",
"cardSecurityCode": "123",
"expiryDate": "2022-10",
"cardHolder": {
"givenName": "John",
"surname": "Smith",
"email": "john@smith.family.priv",
"phone": "+1-555-123-4567",
"address": {
"street": "1230 Ellen Ave, apt 10",
"city": "Dallas",
"stateProvince": "TX",
"postalCode": "75063",
"countryCode": "US"
}
}
}
]
}
}