Skip to main content

Create Reservation

This operation allows you to create a new reservation(s) or modify an existing one(s) in a single request. When creating a reservation one or more IDs will be assigned to the reservation which later is used to identify the reservation during a modification. The response includes the confirmation numbers.

The Reservation APIs support multiple steps in the reservation process where a reservation can be created and updated a number of times with different data elements before the final confirmation. For example, a reservation can be initially created with stay criteria and status=booked, then updated to include non-room products or price overrides and maintain status=booked, then updated again to include guest information and payment information before finally being confirmed using status=confirmed.

REST Method/Endpoint

MethodEndpoint
POSThttps://[environment]/v1/api/reservation

The required information is to create a reservation is:

  • Chain
  • Hotel
  • Product (Room and Rate)
  • Stay Dates
  • Booking Channel
  • Number of Guests
  • Number of Rooms
  • Status

Some statuses might require extra information, namely

  • Confirmed reservation requires a primary guest and/or a guarantee if the policy requires one.

Create Reservation Request

{
    "Chain": {
        "Id": 14161022
    },
    "Channels": {
        "PrimaryChannel": {
            "Code": "WEB"
        },
        "SecondaryChannel": {
            "Code": "WEB"
        },
        "SubSourceCode": "KYK"
    },
    "CommissionableAccountProfile": {
        "TravelIndustryId": "23493923"
    },
    "CouponOffers": [{
        "Code": "CO3"
    }],
    "CRO": {
        "Id": 14161023
    },
    "Guests": [{
        "Citizenships": [{
            "CountryCode": "US",
            "Primary": true
        }],
        "Comments": "This is a guest comment.",
        "ContactNumbers": [{
            "Code": "719",
            "Default": true,
            "Number": "555-2717",
            "Role": "Home",
            "SortOrder": 1,
            "Type": "Voice",
            "Use": "DayTimeContact"
        }],
        "DateOfBirth": "1985-05-18",
        "EmailAddress": [{
            "Type": "Primary",
            "Value": "john.public@email.com",
            "Default": true
        }, {
            "Type": "Mobile",
            "Value": "john.public@email2.com",
            "Default": false
        }],
        "Gender": "Male",
        "Locations": [{
            "Address": {
                "AddressLine": ["123 Main St", "Appt. 201"],
                "City": "Denver",
                "Country": {
                    "Code": "US"
                },
                "Default": true,
                "PostalCode": "80203",
                "StateProv": {
                    "Code": "CO"
                },
                "Type": "Home"
            },
            "Name": "Home Address"
        }],
        "MarketingOptIn": true,
        "Payments": [{
            "Amount": "50",
            "PaymentCard": {
                "CardCode": "VI",
                "CardHolder": "John Public",
                "CardNumber": "444444444444444",
                "CardSecurityCode": "123",
                "ExpireDate": "1225"
            },
            "Type": "CreditCard"
        }],
        "PersonName": {
            "GivenName": "John",
            "MiddleName": "A",
            "Prefix": "Mr.",
            "Suffix": "Jr.",
            "Surname": "Public",
            "PreferredGivenName": "James",
            "PreferredSurname": "Smith"
        },
        "Role": "Primary",
        "SpokenLanguages": [{
            "Code": "en",
            "Default": true
        }],
        "TravelDocuments": [{
            "Type": "MilitaryIdentification",
            "HolderName": "John Public",
            "Number": "2999-9285820-874",
            "IssuingAuthority": "DOJ",
            "PlaceOfIssue": "Houston, TX"
        }]
    }, {
        "Citizenships": [{
            "CountryCode": "US",
            "Primary": true
        }],
        "Comments": "This is a guest comment for guest #2.",
        "ContactNumbers": [{
            "Code": "719",
            "Default": true,
            "Number": "555-2777",
            "Role": "Home",
            "SortOrder": 1,
            "Type": "Voice",
            "Use": "DayTimeContact"
        }],
        "DateOfBirth": "1986-07-22",
        "EmailAddress": [{
            "Type": "Primary",
            "Value": "jane.public@email.com",
            "Default": true
        }],
        "Gender": "Female",
        "MarketingOptIn": true,
        "PersonName": {
            "GivenName": "Jane",
            "MiddleName": "J",
            "Prefix": "Mrs.",
            "Surname": "Public",
            "PreferredGivenName": "Janee",
            "PreferredSurname": "Johnson"
        },
        "Role": "Additional",
        "TravelDocuments": [{
            "Type": "DriversLicense",
            "HolderName": "Jane Public",
            "Number": "93-25-9461",
            "IssuingAuthority": "Colorado",
            "PlaceOfIssue": "Denver, TX"
        }]
    }],
    "Hotel": {
        "Id": 100319
    },
    "LoyaltyMemberships": [{
        "Level": {
            "Code": "Gold"
        },
        "MembershipID": "MY790887688",
        "ProgramID": "MyLoyalty",
        "Source": "Selected"
    }],
    "MarketSegment": {
        "code": "LEISURE"
    },
    "MarketSource": {
        "code": "REFERRAL"
    },
    "Notification": {
        "AdditionalEmailAddresses": ["email2@email.com"],
        "SendBookerEmail": false,
        "SendGuestEmail": true,
        "FromEmailAddress": "myhotel@email.com",
        "LanguageCode": "en-US",
        "EmailTemplate": {
            "Code": "NoPoints",
            "Level": "Hotel"
        },
        "DeliveryComments": [{
            "Comment": "This is a reservation Comment"
        }],
        "PublicComment": "Email comments for the guest."
    },
    "Overrides": [{
        "Type": "GuaranteePolicyOverride",
        "Comment": "Honeymoon"
    }, {
        "Type": "PriceOverride",
        "Comment": "Supervisor Override"
    }],
    "Packages": [{
        "Code": "SPA",
        "Date": "2023-06-07",
        "Quantity": 1,
        "GuestCount": [{
            "AgeQualifyingCode": "Adult",
            "NumGuests": 1
        }] 
    }],
    "Promotion": {
        "AccessKey": {
            "Password": "PROMO3"
        },
        "Type": "Promotion"
    },
    "PurposeOfStay": "Leisure",
    "RoomRequests": [{
        "Code": 50256
    }, {
        "Code": "BREAK"
    }],
    "RoomStay": {
        "StartDate": "2023-06-07",
        "EndDate": "2023-06-08",
        "GuestCount": [{
            "AgeQualifyingCode": "Adult",
            "NumGuests": 2
        }, {
            "AgeQualifyingCode": "Child",
            "NumGuests": 2,
            "Ages": [4, 6]
        }],
        "NumRooms": 1,
        "Products": [{
            "Primary": true,
            "Product": {
                "RateCode": "Dev Studio",
                "RoomCode": "LUXQ"
            }
        }]
    },
    "Source": {
        "IP_Address": "198.162.1.1",
        "BookingURL": "myhotelwebsite.com",
        "Telephony": {
            "VDN": "VDN1234"
        }
    },
    "Transporation": {
        "EstimatedCheckInTime": "12:30 PM",
        "EstimatedCheckOutTime": "2:30 PM",
        "Details": [{
            "TransferRequest": {
                "Code": "TC1",
                "Type": "Arrival",
                "Chargeable": true,
                "RequiresArrangement": true,
                "Time": "1PM",
                "Mode": "Limo"
            },
            "Airline": {
                "Code": "AA",
                "FlightNumber": "1597"
            },
            "Location": {
                "Code": "COS",
                "Type": "Airport"
            }
        }, {
            "TransferRequest": {
                "Code": "TC1",
                "Type": "Departure",
                "Chargeable": true,
                "RequiresArrangement": true,
                "Time": "7AM",
                "Mode": "Limo"
            },
            "Airline": {
                "Code": "AA",
                "FlightNumber": "1598"
            },
            "Location": {
                "Code": "COS",
                "Type": "Airport"
            }
        }]
    },
    "Upgrade": {
        "Reason": {
            "Code": "UPGRD1"
        },
        "RoomToCharge": {
            "Code": "LUXQ"
        },
        "RoomToStay": {
            "Code": "SUITE"
        }
    },
    "status": "Confirmed"
}

 

Create Reservation Response

{
    "Links": {
        "href": "https://edgeapi.sab-certpci-sh-c1-ni-app1.certpci.sabre-gcp.com/frontman/api/v1.0/reservation",
        "rel": "self"
    },
    "reservations": [
        {
            "CRS_confirmationNumber": "100319CK001122",
            "Id": "81d2800e-136f-47b8-abf6-c8fe96432ba7",
            "CrsConfirmationNumber": "100319CK001122",
            "ItineraryNumber": "14161022B0000802"
        }
    ]
}