PropertyResponse
PropertyResponse contains the main hotel property data.
Hotel ID (string_id from dictionary) - v2.1: Added as required field
Human-readable support property ID (format: s123456789)
providerLinks object[]
Provider-specific hotel identifiers (replaces id and hotel_id in v2.0)
Hotel ID from the provider
Provider name (e.g., "sutochno")
Hotel URL
Property type title (e.g., "Отель")
Whether the hotel has only one room
Total number of photos
Hotel name (without type)
Star rating
Hotel rating
Number of reviews
Hotel description
Important information from owner
Property labels (e.g., "guest_choice", "profitable_option")
images object[]required
First 15 photos
Photo ID
Photo URL
Description (nullable)
Blur hash for placeholder effect
executor object
Executor information
Legal entity name
INN (Tax ID)
KPP
OGRN
Phone number
Address
Seller legal status: LEGAL_ENTITY, SOLE_PROPRIETOR, SELF_EMPLOED, INDIVIDUAL, NON_RESIDENT_COMPANY, NON_RESIDENT_INDIVIDUAL
Seller company short name
accredetationInfo object
Accreditation information
Hotel name from hotelInfo
Hotel status
Accommodation type
Registry record number
FSA website URL
Working hours - v2.2: added per spec
cert object
Hotel certificate
Certificate number
Valid until date
location objectrequired
Property location
Hotel address
Location name for breadcrumbs
District/place
Latitude
Longitude
city object
City information
City ID
City name
country object
Country as object with id and title
Sutochno integer ID as string
Display name
relations object
Distance relations
seas object[]
Seas (nullable)
Distance to sea (meters)
Sea name
ropeways object[]
Ropeways (nullable)
group object
Ropeway group
Group ID
Group name
Station ID
Station name
Latitude (nullable)
Longitude (nullable)
Distance (meters)
metro object[]
Metro stations within 20 min walk (nullable)
Station ID
Station name
line object
Metro line
Line ID
Line name
Line color
Latitude (nullable)
Longitude (nullable)
Distance (meters)
Walk time (minutes)
railway object[]
Railway stations (nullable)
Distance (meters)
Railway station name
Latitude (nullable)
Longitude (nullable)
airport object[]
Airports (nullable)
Distance (meters)
Airport name
Latitude (nullable)
Longitude (nullable)
Distance to city center (meters)
region object
Region as object with id and title
Sutochno integer ID as string
Display name
Place ID (integer) - v2.2: added per spec
amenities object[]
Amenities and services
Amenity group (e.g., "AMENITY_GROUP_ROOM")
Amenity title (e.g., "Wi-Fi в номере")
Amenity code (e.g., "AMENITY_INTERNET_ROOMS")
Whether this amenity is paid
Price for paid amenity
Currency code (e.g., "rub", "usd")
Additional information about the amenity
Price unit for paid amenity (daily, period, hourly)
amenitiesTop object[]
Top amenities and services
Amenity group (e.g., "AMENITY_GROUP_ROOM")
Amenity title (e.g., "Wi-Fi в номере")
Amenity code (e.g., "AMENITY_INTERNET_ROOMS")
Whether this amenity is paid
Price for paid amenity
Currency code (e.g., "rub", "usd")
Additional information about the amenity
Price unit for paid amenity (daily, period, hourly)
superguest object
Superguest properties - GO-332: extended with per-permission flags
Whether the property participates in the superguest program
Whether the property offers a discount for superguests
Whether the property allows booking without deposit
info object[]required
Basic hotel properties
Property name (e.g., "area", "floor", "bedrooms")
Property title (e.g., "Площадь (м2)")
Property value (e.g., "45")
bookingRules object[]required
Booking rules
Rule name (e.g., "party", "pets", "smoking")
Rule description (e.g., "вечеринки разрешены")
Rule value (e.g., "0", "1", "14:00")
owner object
Owner information
Owner name
Company name
Gender
Avatar URL
Answer rate (%)
Answer time (minutes)
speakLanguages object[]
Languages spoken
Language name (e.g., "Русский")
Language code (e.g., "russian")
Owner labels/badges
Date when owner was added - v2.1
Date of last login - v2.1
Whether the property is active
roomTypes object[]
Room types available for the property
Room identifier
Object identifier (from platform, needed for calendar and availability checks)
Room name
Room description
images object[]required
Room photos
Photo ID
Photo URL
Description (nullable)
Blur hash for placeholder effect
Number of photos
beds object[]required
Beds in the room
Bed type code (e.g., "BED_TYPE_SINGLE_BED")
Bed type title (e.g., "односпальная кровать")
Number of beds of this type
Whether this is an extra bed
info object[]required
Room properties (area, bedrooms, etc.)
Property name (e.g., "area", "floor", "bedrooms")
Property title (e.g., "Площадь (м2)")
Property value (e.g., "45")
amenities object[]required
Room amenities
Amenity group (e.g., "AMENITY_GROUP_ROOM")
Amenity title (e.g., "Wi-Fi в номере")
Amenity code (e.g., "AMENITY_INTERNET_ROOMS")
Whether this amenity is paid
Price for paid amenity
Currency code (e.g., "rub", "usd")
Additional information about the amenity
Price unit for paid amenity (daily, period, hourly)
bookingRules object[]required
Booking rules
Rule name (e.g., "party", "pets", "smoking")
Rule description (e.g., "вечеринки разрешены")
Rule value (e.g., "0", "1", "14:00")
Important information from owner
superguestPermissions object[]required
Superguest permissions available for the room type
{
"id": "string",
"sPropertyId": "string",
"providerLinks": [
{
"id": "string",
"provider": "string"
}
],
"url": "string",
"typeTitle": "string",
"isSingleRoom": true,
"imagesCount": 0,
"name": "string",
"stars": 0,
"rating": 0,
"reviewCount": 0,
"desc": "string",
"importantInfo": "string",
"labels": [
"string"
],
"images": [
{
"id": "string",
"imageUrl": "string",
"comment": "string",
"blurHash": "string"
}
],
"executor": {
"name": "string",
"inn": "string",
"kpp": "string",
"ogrn": "string",
"phone": "string",
"email": "string",
"address": "string",
"sellerLegalStatus": "string",
"sellerCompanyShortName": "string",
"accredetationInfo": {
"name": "string",
"status": "string",
"recordType": "string",
"record": "string",
"url": "string"
},
"workingHours": "string"
},
"cert": {
"certNum": "string",
"certDate": "string"
},
"location": {
"address": "string",
"location": "string",
"place": "string",
"lat": "string",
"lng": "string",
"city": {
"id": "string",
"title": "string"
},
"country": {
"id": "string",
"title": "string"
},
"relations": {
"seas": [
{
"distance": 0,
"title": "string"
}
],
"ropeways": [
{
"group": {
"id": 0,
"title": "string"
},
"id": 0,
"title": "string",
"lat": "string",
"lng": "string",
"distance": 0
}
],
"metro": [
{
"id": 0,
"title": "string",
"line": {
"id": 0,
"title": "string",
"color": "string"
},
"lat": "string",
"lng": "string",
"distance": 0,
"walkTime": "string"
}
],
"railway": [
{
"distance": 0,
"title": "string",
"lat": "string",
"lng": "string"
}
],
"airport": [
{
"distance": 0,
"title": "string",
"lat": "string",
"lng": "string"
}
],
"center": 0
},
"region": {
"id": "string",
"title": "string"
},
"placeId": 0
},
"amenities": [
{
"group": "string",
"title": "string",
"name": "string",
"isPaid": true,
"price": "string",
"currency": "string",
"optionalInfo": "string",
"priceType": "string"
}
],
"amenitiesTop": [
{
"group": "string",
"title": "string",
"name": "string",
"isPaid": true,
"price": "string",
"currency": "string",
"optionalInfo": "string",
"priceType": "string"
}
],
"superguest": {
"enabled": true,
"superguestDiscount": true,
"withoutDeposit": true
},
"info": [
{
"name": "string",
"title": "string",
"value": "string"
}
],
"bookingRules": [
{
"name": "string",
"title": "string",
"value": "string"
}
],
"owner": {
"name": "string",
"company": "string",
"gender": 0,
"avatar": "string",
"answerRate": 0,
"answerTime": 0,
"speakLanguages": [
{
"title": "string",
"name": "string"
}
],
"labels": [
"string"
],
"dateAdd": "string",
"dateLastLogin": "string"
},
"isActive": true,
"roomTypes": [
{
"id": "string",
"objectId": "string",
"name": "string",
"description": "string",
"images": [
{
"id": "string",
"imageUrl": "string",
"comment": "string",
"blurHash": "string"
}
],
"imageCount": 0,
"beds": [
{
"name": "string",
"title": "string",
"count": 0,
"isExtraBed": true
}
],
"info": [
{
"name": "string",
"title": "string",
"value": "string"
}
],
"amenities": [
{
"group": "string",
"title": "string",
"name": "string",
"isPaid": true,
"price": "string",
"currency": "string",
"optionalInfo": "string",
"priceType": "string"
}
],
"bookingRules": [
{
"name": "string",
"title": "string",
"value": "string"
}
],
"importantInfo": "string",
"superguestPermissions": [
{
"name": "string",
"title": "string"
}
]
}
]
}