--- title: "Read property" method: GET path: "/properties/{propertyId}" tags: ["Property Details API"] --- # Read property `GET /properties/{propertyId}` ## Path parameters - `propertyId` integer, required ## Headers - `Accept-Version` string ## Response `default` default response - ApiResponsePropertyInfoRead - `data` PropertyInfoRead - `translations` Translation[] — Non-English translations of the physical address [Current Documentation](/connectivity/docs/api-reference/addresses/) DataMapping: Addresses - `city_name` string, required — The name of the city, town, or village. [Current Documentation: CityName](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/CityName - `address_line` string, required — The full street name and number. Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters. [Current Documentation: AddressLine](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/AddressLine - `language_code` string, required — Specifies the language of this set of address details. Used for non-English translations As defined by BCL table in docs [Current Documentation](/connectivity/docs/api-reference/address/) DataMapping: Language - `property_name` string, required — Non-english name [Current Documentation](/connectivity/docs/api-reference/address/) DataMapping: Language - `position` Position, required — [Current Documentation](/connectivity/docs/api-reference/position/) Data Mapping: Position - `latitude` number, double, required — Property's latitude. Validation: Must be between -90 and 90 - `longitude` number, double, required — Property's longitude. Validation: Must be between -180 and 180 - `check_in` TimeRange, required — [Current Documentation](/connectivity/docs/api-reference/policyinfo/) Data Mapping: PolicyInfo/CheckInTime/CheckOutTime - `from` string — Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Required for check-in, optional for check-out 24-hour check-in/check-out can be specified using 00:00 as both from and to - `until` string — Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Optional for check-in. If check-out passed, required. 24-hour check-in/check-out can be specified using 00:00 as both from and to - `check_out` TimeRange — [Current Documentation](/connectivity/docs/api-reference/policyinfo/) Data Mapping: PolicyInfo/CheckInTime/CheckOutTime - `from` string — Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Required for check-in, optional for check-out 24-hour check-in/check-out can be specified using 00:00 as both from and to - `until` string — Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Optional for check-in. If check-out passed, required. 24-hour check-in/check-out can be specified using 00:00 as both from and to - `property_name` string, required — Specifies the name of the property on Booking.com. Validation: We do not allow CJK Unified Ideographs. Should be shorter than 255 characters. Must have at least 3 letters, one of which must be lower case. Must not have more than 5 numbers. Can't include punctuation, asterisks or symbols. [Current Documentation](/connectivity/docs/api-reference/hoteldescriptivecontent/) DataMapping: HotelName - `property_category` integer — The Property Class Type Code for the property. Validation: One of [(PCT) Property Class Type Codes (OTA 2014B)](/connectivity/docs/codes-pct/). During creation, either property_category or booking_property_category are required. [Current Documentation](/connectivity/docs/api-reference/hotelcategory/) DataMapping: HotelCategory/Code - `booking_property_category` integer — The Booking.com code for property_category. Utilize the meta endpoint for valid values and their OTA mappings. Validation: During creation, either property_category or booking_property_category are required. - `primary_language` string — Specifies the language in which the property wants their Booking.com extranet content and communication (emails, notifications, ...) etc. Validation: One of [Booking.com Language Code](/connectivity/docs/codes-bcl/) Default: en-gb [Current Documentation](/connectivity/docs/api-reference/hoteldescriptivecontent/) DataMapping: LanguageCode - `languages_spoken` string[] — The languages spoken by staff. Validation: One of [Booking.com Language Code](/connectivity/docs/codes-bcl/) DataMapping: HotelInfo->Languages - `room_count` integer, required — The number of sellable units the property offers. DataMapping: GuestRoomInfo->Quantity - `floor_count` integer — Total number of floors the building has (excl. underground floors). Validation: Max value of 200 DataMapping: TotalNumberOfFloors->Number - `provider_property_id` string — An external id to be associated with the property (e.g. the providers internal id) Validation: Maximum length of 16 characters DataMapping: HotelInfo-ID - `currency_code` string — Booking.com defines the currency for each property. In most cases this should not be passed as only one currency is allowed per country. Retrieve a list of all currency codes with /xml/currencies Validation: Must be allowed for property's country [Current Documentation](/connectivity/docs/api-reference/hoteldescriptivecontent/) Data Mapping: currencyCode - `stars` string — The number of stars a property has. Validation: String with values 0 through 5, optionally may include half stars for values 1 or greater (i.e. 0, 1, 1.5, 2, 2.5 ... 4, 4.5, 5) Default: 0 DataMapping: AffiliationInfo->Awards->Award - `target` 'test' | 'production', required — Specifies whether the request is to create a test property or a real property. Validation: String value of production or test DataMapping: Target - `property_id` integer — The Booking.com property ID, returned on creation of the property. [Current Documentation](/connectivity/docs/api-reference/hoteldescriptivecontent/) Data Mapping: HotelCode - `status` string — The current status of the property. [Current Documentation](/connectivity/docs/property-statuses/#property-statuses) Data Mapping: hoteldescriptivecontent->Status - `url` string — The booking URL of the property (if available). [Current Documentation](/connectivity/docs/tsk-retrieve-property/#response-body-parameters) Data Mapping: HotelInfo->Descriptions->MultimediaDescriptions->...->TextItem->URL - `physical_address` Address, required - `city_name` string, required — The name of the city, town, or village. Validation: We do not allow CJK Unified Ideographs [Current Documentation: CityName](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/CityName - `country_code` string, required — [Two-letter country code](/connectivity/docs/b_xml-countries/). Validation: One of [Two-letter country code](/connectivity/docs/b_xml-countries/) Country codes follow ISO 3166 [Current Documentation: CountryName](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/CountryName - `postal_code` string — Postal/zip code. Validation: We validate against country specific post code formats. [Current Documentation: PostalCode](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/PostalCode - `address_line` string, required — The full street name and number. Validations: Minimum 1 at most 255 characters. We also do not allow CJK Unified Ideographs. Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters. [Current Documentation: AddressLine](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/AddressLine - `display_address` boolean — Specifies whether to hide the address details. Defaults to true. [Current Documentation: HiddenAddress](/connectivity/docs/api-reference/hidden-address/) DataMapping: ContactInfo/HiddenAddress/ShouldHideAddress - `legal_entity_id` integer, required — The leid for the property. [Current Documentation](/connectivity/docs/api-reference/companyname/) DataMapping: HotelInfo/OwnershipManagementInfos/OwnershipManagementInfo/CompanyName/Code - `warnings` ApiErrorOTA[] - `message` string - `code` integer - `details` ObjectNode - `description` string - `errors` ApiErrorOTA[] - `message` string - `code` integer - `details` ObjectNode - `description` string - `meta` ResponseMeta - `ruid` string --- [API](https://skmtc.net/booking/apis/property-api.md) · [All operations](https://skmtc.net/booking/apis/property-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/property-api/revisions/491461b029b5/schema)