FPLOS Pricing

Length-of-stay (LOS) pricing lets a channel manager set a total price for a specific check-in date, occupancy range, and number of nights. Use the LOS Pricing APIs only for properties configured for the FPLOS pricing model.

LOS Pricing updates rates and optional rate-plan restrictions. It does not update room allotment. A room must have allotment for the relevant stay dates before the rate can be sold.

Endpoints

OperationMethod and pathContent type
Set LOS pricingPOST /api/rate/fplosapplication/json
Search LOS pricingPOST /api/rate/fplos/searchapplication/json
Set room allotmentPOST /api/v2/ariapplication/xml

Prerequisites

Before setting LOS pricing, confirm that:

  • The property, room, and rate plan are active.
  • The property is enabled for FPLOS pricing.
    Please ask property to contact support team to change from Occupancy model to FPLOS setting.
    Remark:
    • Once change to FPLOS, Property ARI Rates, RateCategory Child Prices, Surcharges will be removed.
    • Promotions continue using the normal promotion. The promotion discount can apply to FPLOS base price for the check-in date, LOS and occupancy.
    • For FPLOS property, Agoda Partner Portal Calendar is not the source of truth. It does not represent the complete date × LOS × occupancy FPLOS price matrix. FPLOS rates and restrictions should be checked through CMAPI FPLOS Search endpoint.

Use the Get Products operation to obtain active room and rate-plan identifiers, the property currency, occupancy limits, LOS limits, and configured minimum and maximum rates.

Recommended update sequence

  1. Set room allotment through SetARI V2.
  2. Set LOS prices and optional rate-plan restrictions.
  3. Search LOS pricing until the expected rates are available.

SetARI V2 and Set LOS Pricing use asynchronous downstream processing. A success response confirms that CMAPI accepted the update for processing; it does not guarantee immediate read-after-write availability. Poll Search LOS Pricing with bounded retries and backoff. If the expected data does not become available, contact support with the TUID returned by the Set response.


Did this page help you?