OWownerrez
Discounts

Query for a pageable list of discounts.

Changed on

Discounts are the reusable discount templates (length-of-stay, promotions, and other reductions) applied to bookings.

get/v2/discounts

Request

  • Base URL
    https://api.ownerrez.com
  • URL
    https://api.ownerrez.com/v2/discounts
  • Auth
    • HTTP bearer
    • or HTTP basic

Query parameters

since_utcstring date-time nullable

Filter for records created or changed since a specific date (UTC).

activeboolean nullable

Filter by active status.

typeSurchargeType[] nullable

Filter by type (comma-separated, e.g. CleaningFee, LengthOfStayDiscount).

category'additional_bed' | 'administrative' | 'air_conditioning' | 'arrival_early' | 'arrival_late' | 'association_property' | 'baby_bed' | 'booking' | 'booking_early' | 'booking_late' | 'city_tax' | 'class' | 'cleaning' | 'club' | 'concierge' | 'consumption' | 'daily_cleaning' | 'departure_early' | 'departure_late' | 'deposit_damage' | 'electricity' | 'energy' | 'equipment' | 'final_cleaning' | 'food' | 'gardening' | 'gas' | 'guest' | 'heating' | 'high_chair' | 'hot_tub' | 'internet' | 'labor' | 'laundry' | 'linens' | 'linens_bath' | 'linens_bed' | 'management' | 'oil' | 'on_site_payment_method' | 'parking' | 'pet' | 'phone' | 'pool' | 'pool_heating' | 'property_fee' | 'rent' | 'reservation' | 'resort' | 'service' | 'spa' | 'tax' | 'toiletries' | 'tour' | 'tourist_tax' | 'transportation' | 'utensils_cleaning' | 'utensils_food' | 'vehicle' | 'waiver_damage' | 'water' | 'water_craft' | 'water_craft_mooring' | 'water_drinking' | 'wood' | 'discount' | 'cancellation_fee' | 'other'

Filter by income category.

mode'automatic' | 'optional' | 'manual' | 'code' | 'offline'

Filter by mode (Automatic, Optional, Manual, Code, Offline).

property_idinteger nullable

Filter to records applicable to a specific property.

limitinteger

Maximum records to return. Default 20, maximum 100.

offsetinteger

Deprecated: rejected above 0 from 2027-01-05. Follow next_page_url instead. Records to skip from the start of the collection. Default 0.

cursorstring

Opaque cursor from a previous response's next_page_url. Prefer following that link over computing offsets: a cursor pages by record id, so rows inserted while you page are not skipped or repeated. A cursor issued under different filters is ignored and paging falls back to offset.

Response

A pageable list of view models.

limitinteger

The maximum number of records per page.

next_page_urlstring

URL to fetch the next page of records. A null value indicates that there are no more pages in the collection.

offsetinteger

The current offset from the start of the collection.

Changes

  • f47aebc78c5dRevision changes
    • info

      added the new optional query request parameter cursor

    • info

      query request parameter offset was deprecated

  • 35db8ad62f61Revision changes
    • warning

      added the new stay_date enum value to the ///////////// response property for the response status

    • warning

      added the new stay_date enum value to the ///////// response property for the response status