Skip to main content

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) with Secure Flight Passenger Data details

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"
                }
            ],
            "identityDocuments": [
                {
                    "documentType": "SECURE_FLIGHT_PASSENGER_DATA",
                    "gender": "MALE"
                }
            ]
        }
    ],
    "contactInfo": {
        "emails": [
            "travel@sabre.com"
        ],
        "phones": [
            "123456"
        ]
    }
}

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 NDC booking (order) for a single traveler (corporate loyalty program included)

To ensure a successful booking, pass a valid offerID, selectedOfferItems, and the traveler id returned by the Offer Price API.

Note: Remember that only one corporate loyalty program is allowed. It should be submitted for the first traveler only.

{
    "asynchronousUpdateWaitTime": 4000,
    "flightOffer": {
        "offerId": "{{price_offer_id}}",
        "selectedOfferItems": [
            "{{price_offer_item_id}}"
        ]
    },
    "travelers": [
        {
            "id": "{{price_passenger_id}}",
            "givenName": "John",
            "surname": "Doe",
            "birthDate": "1970-01-23",
            "passengerCode": "ADT",
            "customerNumber": "1234567",
            "loyaltyPrograms": [
                {
                    "supplierCode": "AA",
                    "programNumber": "{{AA_program_number_1}}",
                    "programType": "CORPORATE_LOYALTY_ID"
                }
            ]
        }
    ],
    "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"
          }
        }
      }
    ]
  }
}