Watched rates

Modes: rates
Dataset view: rates — ?view=rates on the items API, or the matching tab in the Console.

One row per watched product id: whether that exact rate is still on sale for your stay, and at what price. A rate that has gone still occupies a full row, with status and reason saying why.

27 columns, in the order the view shows them.

Inside the nested columns

Some columns above carry an object, or a list of objects, with documented members of their own. Each table below lists the members documented at ONE level; a member that is itself an object names the table it continues in, and [] in a path means a list.

row
├─ price
├─ provenance
└─ product
   ├─ policies
   │  ├─ meal_plan
   │  │  └─ offers[]
   │  ├─ payment
   │  └─ deposit
   └─ price

price — Price

Parent chain: row → price

On a property row, the price object: base, book/total, per_night and extra_charges. On a rate or attraction row, a plain number. Read total_with_charges to match what the buyer is shown - it is right on every path, which total is not. Where Booking excludes taxes from its display price, total understates: measured on a search row, display EUR 246.28 with EUR 82.50 of excluded charges beside it. Where the taxes are already inside gross_amount, the two are the same number and both match the screen: measured on a room-list rate, MYR 151 on the app’s price sheet against MYR 151.305 on the wire. discount_percent is not Booking’s badge: it is computed from Booking’s own figures and moves with the point of sale, so use it to rank savings within a run rather than to reproduce what a browser shows.

provenance — Provenance

Parent chain: row → provenance

What produced this row’s price: the proxy exit it was fetched through, the generation of that exit, the currency you asked for and the endpoint that priced it. The point of sale follows the proxy exit country, not any input - bookerCountry was removed in this build because nothing read it.

product — Rate

Parent chain: row → product

One bookable rate — the same object an entry of products holds on a property row. Only the members documented at this level are listed below; a rate carries the rest of its columns (price, occupancy, deal, room, fit) as described in the product row of the table above.

product.policies — Policies

Parent chain: row → product → policies

The rate’s commercial terms: cancellation, meal plan, payment timing, prepayment and deposit.

product.policies.meal_plan — Meal plan

Parent chain: row → product → policies → meal_plan

What the rate includes, and what else can be bought with it.

product.policies.meal_plan.offers[] — Meal offer

Parent chain: row → product → policies → meal_plan → offers[]

One meal this rate can carry, and on what terms.

product.policies.payment — Payment policy

Parent chain: row → product → policies → payment

When the rate is paid, which is timing rather than amount.

product.policies.deposit — Deposit (prepayment) policy

Parent chain: row → product → policies → deposit

The pay-now / pay-later flag, NOT a damage deposit - despite Booking calling the field deposit_required on the wire. True means prepayment is taken at booking. A real damage deposit is details.damageDeposit, and the two are unrelated: one is when the rate is paid, the other is money left at the desk and refunded. noPaymentDueAtBooking and payment.types answer different questions - the first is whether anything is taken now, the second is when the rate is settled - so a rate can require no payment now and still be pay_now for the balance.

product.price — Rate price

Parent chain: row → product → price

What this rate costs for the whole requested stay - the party and the nights you asked for, already expanded, not a per-night or per-person figure. It states its own currency rather than borrowing the row’s (#86), because it does not always match: the total falls back to Booking’s gross_amount_hotel_currency when the ordinary amount is absent, and that field is the PROPERTY’s currency.

A real row

Captured from a live run. Lists are cut to two entries and deep nesting is elided — the shape is real, the bulk is not.

{
  "recordType": "rate",
  "productId": "17622630_89064837_1_0_0",
  "hotelId": 176226,
  "checkin": "2026-10-31",
  "checkout": "2026-11-01",
  "adults": 1,
  "roomsRequested": 1,
  "status": "available",
  "available": true,
  "reason": null,
  "roomName": "Standard Twin Room",
  "price": 70.54,
  "priceWithCharges": 81,
  "pricePerNight": 70.54,
  "currency": "EUR",
  "cancellationType": "non_refundable",
  "freeCancellationUntil": null,
  "prepaymentPolicy": "full_prepayment",
  "paymentTypes": [
    "pay_now"
  ],
  "mealPlan": "no_plan",
  "breakfastAvailableForFee": false,
  "breakfastPrice": null,
  "breakfastCurrency": null,
  "product": {
    "id": "17622630_89064837_1_0_0",
    "room": 17622630,
    "roomTypeId": 8,
    "roomTypeCode": "TWIN",
    "pricedPerBed": false,
    "roomName": "Standard Twin Room",
    "children": [],
    "deal": null,
    "isSmoking": false,
    "number_available_at_this_price": 20,
    "number_of_adults": 1,
    "fitsParty": true,
    "fitStatus": 2,
    "occupancy": {
      "adults": 1,
      "children": 0,
      "childrenAges": [],
      "requestedAdults": 1,
      "requestedChildrenAges": []
    },
    "maxOccupancy": 1,
    "bedroomCount": null,
    "bathroomCount": null,
    "privateBathroom": true,
    "policies": {
      "cancellation": "{... 9 keys}",
      "meal_plan": "{... 5 keys}",
      "payment": "{... 8 keys}",
      "deposit": "{... 4 keys}"
    },
    "price": {
      "base": 70.54,
      "book": 70.54,
      "total": 70.54,
      "per_night": 70.54,
      "extra_charges": "{... 12 keys}",
      "total_with_charges": 81
    }
  }
}