Create property settings

Request

Security

bearerAuth

Path

propertyIdinteger, (int32)required

Bodyapplication/json

property_settingsobject(property_settings)

Contains multiple various settings related to the property

petsobject(pets)

Contains settings related to the pets allowance

damage_policyobject(damage_policy)

standard_phrasesArray of objects(StandardPhraseData)

quiet_hoursobject(quiet_hours)

renovationobject(renovation)

bed_linen_policyobject(hotel_chain_bed_linen)

accepted_payment_typesobject(accepted_payment_types)

List of payment methods. For more information, see the full list of payment codes.

french_tax_detailsobject(french_tax_details)

cancellation_exceptionsobject(cancellation_exceptions)

age_bucketsArray of objects(AgeBucketData)

An age bucket is a category for children prices that specifies the age range to which the eventual price applies to. You must at least create one, but can create up to four age buckets per property. Each age bucket exists of a minimum and maximum age, where the maximum age is inclusive. Ages must be from 0 to 17, and buckets must be contiguous: each bucket's min_age must equal the previous bucket's max_age plus 1.

children_policiesobject(children_policies)

You can indicate whether a property accepts children and specify: price, occupancy and what age children are welcome

booking_modelobject(booking_model)

Specify whether the property uses the Request to Book model. Availability depends on the property meeting the eligibility requirements. See Request to Book eligibility.

invoice_settingsobject(invoice_settings)

land_registration_numbersArray of strings

curl -i -X POST \
  'https://developers.booking.com/_mock/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/properties/{propertyId}/settings' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "property_settings": {
      "require_cvc": true,
      "view_cc_details": true,
      "curfew": {
        "enabled": true,
        "start": "18:00",
        "end": "09:00"
      },
      "require_booker_address": true,
      "require_booker_phone_number": true,
      "age_restriction": {
        "enabled": true,
        "min": 18,
        "max": 99
      },
      "auto_replenish": true,
      "replenish_closed_rooms": true,
      "long_stay": {
        "enabled": true,
        "max_length_of_stay": 45
      },
      "pricing_type": "Standard",
      "allow_smoking": true
    },
    "pets": {
      "pets_allowed": "PETS_NOT_ALLOWED",
      "pets_price_type": "FREE"
    },
    "damage_policy": {
      "amount": 90,
      "policy_type": "HANDLED_BY_PROPERTY",
      "damage_programme_terms_agreed": false,
      "collection_mode": "CASH",
      "return_mode": "CASH",
      "collection_when": "ON_ARRIVAL",
      "return_when": "ON_CHECKOUT"
    },
    "standard_phrases": [
      {
        "name": "GuestIdentification",
        "enabled": true
      }
    ],
    "quiet_hours": {
      "enabled": true,
      "start": "18:00",
      "end": "08:30"
    },
    "renovation": {
      "enabled": true,
      "start": "2014-01-01",
      "end": "2014-01-10"
    },
    "bed_linen_policy": {
      "enabled": true,
      "amount": 100
    },
    "accepted_payment_types": {
      "codes": [
        1,
        2,
        55
      ]
    },
    "french_tax_details": {
      "category_id": "11",
      "nature_id": "1",
      "declare_revenue": true,
      "has_vat": true,
      "registered_in_rcs": true
    },
    "cancellation_exceptions": {
      "grace_period": {
        "enabled": true,
        "after_booking": "HOURS_4"
      },
      "advance_cancellation": {
        "enabled": true,
        "before_check_in": "WEEKS_4"
      }
    },
    "age_buckets": [
      {
        "min_age": 1,
        "max_age": 10
      }
    ],
    "children_policies": {
      "allow_children": true,
      "min_age": 0,
      "policy_rules": [
        {
          "rule_type": "EXISTING_BED",
          "from_age": 0,
          "to_age": 10,
          "price_type": "FIXED",
          "price_mode": "PER_STAY",
          "price": 0
        }
      ]
    },
    "booking_model": {
      "type": "IB"
    },
    "invoice_settings": {
      "legal_name": "string",
      "contact_person": "string",
      "address": "string",
      "country_code": "string",
      "city": "string",
      "postal_code": "string",
      "state": "st",
      "notification_channel": "POSTAL_MAIL",
      "brazil_tax_details": {
        "tax_payer_number_type": "CNPJ",
        "tax_payer_number": "string",
        "city_hall_id": "string",
        "email": "string"
      }
    }
  }'

Responses

Property settings created or updated successfully.

Bodyapplication/json

dataobject

Example:

{
  "property_setting_1": {
    "success": true
  },
  "property_setting_2": {
    "success": true
  }
}

warningsArray of objects(ApiErrorOTA)

errorsArray of objects(ApiErrorOTA)

metaobject(ResponseMeta)

Response

{
  "data": {
    "property_settings": { … },
    "pets": { … },
    "damage_policy": { … },
    "standard_phrases": { … },
    "quiet_hours": { … },
    "renovation": { … },
    "bed_linen_policy": { … },
    "accepted_payment_types": { … },
    "french_tax_details": { … },
    "cancellation_exceptions": { … },
    "age_buckets": { … },
    "child_policies": { … },
    "booking_model": { … },
    "invoice_settings": { … },
    "land_registration_numbers": { … }
  },
  "warnings": [],
  "errors": [],
  "meta": {
    "ruid": "4a713cab-61c6-43f0-bd39-f87ba830b5ed"
  }
}