Beta version

This API endpoint is currently in beta. Make sure to direct any questions during the beta phase to your contact person via the appropriate channels.

Troubleshooting Policy error codes

This section captures the list of common HTTP errors you can encounter together with possible solutions to fix them.

HTTP Error Code Error Text Reason Possible Fix
400 Expecting exactly 1 hotel ID in the request The request has 0 or more than 1 hotel ID specified. Make sure to specify only one hotel ID.
400 Bad request The request contains invalid or missing body parameters. Make sure to specify all the required body parameters. For a complete list of body parameters when creating/updating a policy, see Managing Policies.
400 Policy ID is not valid The request contains an incorrect policy ID. Make sure to specify the correct policy ID. To get the list of policy IDs created for a property, see Retrieving policy details.
400 Reached maximum number of allowed policies... The policy limit count of 7 for individual properties has been reached. Edit an existing policy to specify the new policy code. For more information on how to edit a policy, see Edit policy details.
400 Missing required field 'cancelpenalty' The request does not contain the mandatory cancelpenalty parameter. Make sure to specify the cancelpenalty parameter. See Managing Policies. for more information
400 CANCEL_PENALTY_NOT_AVAILABLE The specified cancellation code does not exist in the list of available codes. Make sure to specify an existing cancellation code. See List of cancellation policy codes. for more information
403 Request for forbidden hotel ID(s) The specified hotel ID is invalid or the machine account credentials do not have access to the specified hotel ID. Make sure to specify the correct hotel ID or check your machine account credentials.
500 Internal server error The web server is currently not responding. servers are currently busy. Make sure to try again a little later.

Creating a duplicate policy returns an error

When creating a duplicate cancellation policy with the same combination of penalty code, guarantee payment and no show penalty conditions, the API returns an error along with the details of the existing cancellation policy.

<?xml version='1.0' encoding='UTF-8'?>
        <Policy Id="341337682" GroupName="general" Type="Cancellation">
            <CancelPenalty PolicyCode="568"/>
            <NoShowPolicy Penalty="default"/>
            <GuaranteePayment Required="false" EffectiveFrom="after_reservation_is_made"/>
        <Error Code="DUPLICATE_POLICY" ShortText="Cannot have 2 policies with the same cancellation and prepayment codes">
<!-- RUID: [UmFuZG9tSVYkc2RlIyh9Yc2VQEtEQcWis2P7po9uf/HW/V97Zg8yxXcJRBupSbBiP1BtpRH5az5Fe10g+nziEQ==] --