Refresh a listing | PriceLabs

{
  "pricing_array": [
    {
      "date": "2026-08-25",
      "price": "233",
      "user_price": "233",
      "uncustomized_price": "55",
      "min_price": "233",
      "max_price": "930",
      "min_stay": "3",
      "dso_flag": "0",
      "listing_dso_flag": "0",
      "group_dso_flag": "0",
      "sub_group_dso_flag": "0",
      "acc_dso_flag": "0",
      "num_bookings": "0",
      "unbookable": "0",
      "demand": "0",
      "reasons_json": "{\"listing_info\": {...}, \"market_factors\": {...}, \"pricing_customizations\": {...}, \"thresholds\": {...}}"
    }
  ]
}

Recalculates prices for a listing on demand — the API equivalent of “Save & Refresh” in the PriceLabs app.

Writes such as date-specific overrides are stored immediately but do not trigger a recalculation on their own: the prices returned by POST /v1/listing_prices update at the next scheduled refresh (roughly every 24 hours). Call this endpoint after making your changes to apply them right away. The call is synchronous and returns the freshly computed pricing calendar in the response, so you can verify your changes in the same round trip.

Rate limits: 3 calls per listing per 24 hours, and 10 calls per account per minute. Batch all changes for a listing before refreshing it.

Recalculates prices for a listing on demand — the API equivalent of "Save & Refresh" in the PriceLabs app. Writes such as [date-specific overrides](api:capi:POST/v1/listings/{listing_id}/overrides) are stored immediately but do not trigger a recalculation on their own: the prices returned by [POST /v1/listing_prices](api:capi:POST/v1/listing_prices) update at the next scheduled refresh (roughly every 24 hours). Call this endpoint after making your changes to apply them right away. The call is synchronous and returns the freshly computed pricing calendar in the response, so you can verify your changes in the same round trip. > **Rate limits:** 3 calls per listing per 24 hours, and 10 calls per account per minute. Batch all changes for a listing before refreshing it.

Request

This endpoint expects an object.

listing_idstringRequired

Unique listing ID. The listing must exist in your PriceLabs account.

pmsstringRequired

PMS name for the listing. Must match the PMS the listing is connected under in PriceLabs.

Response

Success — the listing was recalculated. The response contains the freshly computed pricing calendar.

pricing_arraylist of objectsOptional

One entry per date of the listing’s pricing calendar, computed by this refresh. Values are returned as strings; -1 denotes “not set”. Additional internal fields may also be present.

Errors

400

Bad Request Error

429

Too Many Requests Error

$	curl -X POST https://api.pricelabs.co/v1/refresh_listing \
>	-H "X-API-Key: {{API_KEY}}" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"listing_id": "ABCDEF",
>	"pms": "pms"
>	}'

Headers

Request

Response

Errors