Перейти к основному содержимому

GetHotelPropertyResponse

GetHotelPropertyResponse wraps the response in SuccessResponse format.

successbooleanrequired
data objectrequired

PropertyResponse contains the main hotel property data.

idstringrequired

Hotel ID (string_id from dictionary) - v2.1: Added as required field

sPropertyIdstring

Human-readable support property ID (format: s123456789)

providerLinks object[]

Provider-specific hotel identifiers (replaces id and hotel_id in v2.0)

  • Array [
  • idstringrequired

    Hotel ID from the provider

    providerstringrequired

    Provider name (e.g., "sutochno")

  • ]
  • urlstringrequired

    Hotel URL

    typeTitlestringrequired

    Property type title (e.g., "Отель")

    isSingleRoombooleanrequired

    Whether the hotel has only one room

    imagesCountinteger<int32>required

    Total number of photos

    namestringrequired

    Hotel name (without type)

    starsinteger<int32>

    Star rating

    ratingnumber<double>

    Hotel rating

    reviewCountinteger<int32>

    Number of reviews

    descstring

    Hotel description

    importantInfostring

    Important information from owner

    labelsstring[]

    Property labels (e.g., "guest_choice", "profitable_option")

    images object[]required

    First 15 photos

  • Array [
  • idstringrequired

    Photo ID

    imageUrlstringrequired

    Photo URL

    commentstring

    Description (nullable)

    blurHashstring

    Blur hash for placeholder effect

  • ]
  • executor object

    Executor information

    namestringrequired

    Legal entity name

    innstring

    INN (Tax ID)

    kppstring

    KPP

    ogrnstring

    OGRN

    phonestring

    Phone number

    emailstring

    Email

    addressstring

    Address

    sellerLegalStatusstring

    Seller legal status: LEGAL_ENTITY, SOLE_PROPRIETOR, SELF_EMPLOED, INDIVIDUAL, NON_RESIDENT_COMPANY, NON_RESIDENT_INDIVIDUAL

    sellerCompanyShortNamestring

    Seller company short name

    accredetationInfo object

    Accreditation information

    namestring

    Hotel name from hotelInfo

    statusstring

    Hotel status

    recordTypestring

    Accommodation type

    recordstring

    Registry record number

    urlstring

    FSA website URL

    workingHoursstring

    Working hours - v2.2: added per spec

    cert object

    Hotel certificate

    certNumstringrequired

    Certificate number

    certDatestringrequired

    Valid until date

    location objectrequired

    Property location

    addressstringrequired

    Hotel address

    locationstring

    Location name for breadcrumbs

    placestring

    District/place

    latstringrequired

    Latitude

    lngstringrequired

    Longitude

    city object

    City information

    idstringrequired

    City ID

    titlestringrequired

    City name

    country object

    Country as object with id and title

    idstringrequired

    Sutochno integer ID as string

    titlestringrequired

    Display name

    relations object

    Distance relations

    seas object[]

    Seas (nullable)

  • Array [
  • distanceinteger<int32>required

    Distance to sea (meters)

    titlestringrequired

    Sea name

  • ]
  • ropeways object[]

    Ropeways (nullable)

  • Array [
  • group object

    Ropeway group

    idinteger<int32>required

    Group ID

    titlestringrequired

    Group name

    idinteger<int32>required

    Station ID

    titlestringrequired

    Station name

    latstring

    Latitude (nullable)

    lngstring

    Longitude (nullable)

    distanceinteger<int32>required

    Distance (meters)

  • ]
  • metro object[]

    Metro stations within 20 min walk (nullable)

  • Array [
  • idinteger<int32>required

    Station ID

    titlestringrequired

    Station name

    line object

    Metro line

    idinteger<int32>required

    Line ID

    titlestringrequired

    Line name

    colorstringrequired

    Line color

    latstring

    Latitude (nullable)

    lngstring

    Longitude (nullable)

    distanceinteger<int32>required

    Distance (meters)

    walkTimestring

    Walk time (minutes)

  • ]
  • railway object[]

    Railway stations (nullable)

  • Array [
  • distanceinteger<int32>required

    Distance (meters)

    titlestring

    Railway station name

    latstring

    Latitude (nullable)

    lngstring

    Longitude (nullable)

  • ]
  • airport object[]

    Airports (nullable)

  • Array [
  • distanceinteger<int32>required

    Distance (meters)

    titlestring

    Airport name

    latstring

    Latitude (nullable)

    lngstring

    Longitude (nullable)

  • ]
  • centerinteger<int32>

    Distance to city center (meters)

    region object

    Region as object with id and title

    idstringrequired

    Sutochno integer ID as string

    titlestringrequired

    Display name

    placeIdinteger<int32>

    Place ID (integer) - v2.2: added per spec

    amenities object[]

    Amenities and services

  • Array [
  • groupstringrequired

    Amenity group (e.g., "AMENITY_GROUP_ROOM")

    titlestringrequired

    Amenity title (e.g., "Wi-Fi в номере")

    namestringrequired

    Amenity code (e.g., "AMENITY_INTERNET_ROOMS")

    isPaidboolean

    Whether this amenity is paid

    pricestring

    Price for paid amenity

    currencystring

    Currency code (e.g., "rub", "usd")

    optionalInfostring

    Additional information about the amenity

    priceTypestring

    Price unit for paid amenity (daily, period, hourly)

  • ]
  • amenitiesTop object[]

    Top amenities and services

  • Array [
  • groupstringrequired

    Amenity group (e.g., "AMENITY_GROUP_ROOM")

    titlestringrequired

    Amenity title (e.g., "Wi-Fi в номере")

    namestringrequired

    Amenity code (e.g., "AMENITY_INTERNET_ROOMS")

    isPaidboolean

    Whether this amenity is paid

    pricestring

    Price for paid amenity

    currencystring

    Currency code (e.g., "rub", "usd")

    optionalInfostring

    Additional information about the amenity

    priceTypestring

    Price unit for paid amenity (daily, period, hourly)

  • ]
  • superguest object

    Superguest properties - GO-332: extended with per-permission flags

    enabledboolean

    Whether the property participates in the superguest program

    superguestDiscountboolean

    Whether the property offers a discount for superguests

    withoutDepositboolean

    Whether the property allows booking without deposit

    info object[]required

    Basic hotel properties

  • Array [
  • namestringrequired

    Property name (e.g., "area", "floor", "bedrooms")

    titlestringrequired

    Property title (e.g., "Площадь (м2)")

    valuestringrequired

    Property value (e.g., "45")

  • ]
  • bookingRules object[]required

    Booking rules

  • Array [
  • namestringrequired

    Rule name (e.g., "party", "pets", "smoking")

    titlestringrequired

    Rule description (e.g., "вечеринки разрешены")

    valuestring

    Rule value (e.g., "0", "1", "14:00")

  • ]
  • owner object

    Owner information

    namestring

    Owner name

    companystring

    Company name

    genderinteger<int32>

    Gender

    avatarstring

    Avatar URL

    answerRateinteger<int32>

    Answer rate (%)

    answerTimeinteger<int32>

    Answer time (minutes)

    speakLanguages object[]

    Languages spoken

  • Array [
  • titlestringrequired

    Language name (e.g., "Русский")

    namestringrequired

    Language code (e.g., "russian")

  • ]
  • labelsstring[]

    Owner labels/badges

    dateAddstring

    Date when owner was added - v2.1

    dateLastLoginstring

    Date of last login - v2.1

    isActiveboolean

    Whether the property is active

    roomTypes object[]

    Room types available for the property

  • Array [
  • idstringrequired

    Room identifier

    objectIdstringrequired

    Object identifier (from platform, needed for calendar and availability checks)

    namestringrequired

    Room name

    descriptionstringrequired

    Room description

    images object[]required

    Room photos

  • Array [
  • idstringrequired

    Photo ID

    imageUrlstringrequired

    Photo URL

    commentstring

    Description (nullable)

    blurHashstring

    Blur hash for placeholder effect

  • ]
  • imageCountinteger<int32>required

    Number of photos

    beds object[]required

    Beds in the room

  • Array [
  • namestringrequired

    Bed type code (e.g., "BED_TYPE_SINGLE_BED")

    titlestringrequired

    Bed type title (e.g., "односпальная кровать")

    countinteger<int32>required

    Number of beds of this type

    isExtraBedbooleanrequired

    Whether this is an extra bed

  • ]
  • info object[]required

    Room properties (area, bedrooms, etc.)

  • Array [
  • namestringrequired

    Property name (e.g., "area", "floor", "bedrooms")

    titlestringrequired

    Property title (e.g., "Площадь (м2)")

    valuestringrequired

    Property value (e.g., "45")

  • ]
  • amenities object[]required

    Room amenities

  • Array [
  • groupstringrequired

    Amenity group (e.g., "AMENITY_GROUP_ROOM")

    titlestringrequired

    Amenity title (e.g., "Wi-Fi в номере")

    namestringrequired

    Amenity code (e.g., "AMENITY_INTERNET_ROOMS")

    isPaidboolean

    Whether this amenity is paid

    pricestring

    Price for paid amenity

    currencystring

    Currency code (e.g., "rub", "usd")

    optionalInfostring

    Additional information about the amenity

    priceTypestring

    Price unit for paid amenity (daily, period, hourly)

  • ]
  • bookingRules object[]required

    Booking rules

  • Array [
  • namestringrequired

    Rule name (e.g., "party", "pets", "smoking")

    titlestringrequired

    Rule description (e.g., "вечеринки разрешены")

    valuestring

    Rule value (e.g., "0", "1", "14:00")

  • ]
  • importantInfostring

    Important information from owner

    superguestPermissions object[]required

    Superguest permissions available for the room type

  • Array [
  • namestringrequired
    titlestringrequired
  • ]
  • ]
  • errorsstring[]required
    actionsstring[]required
    platformstringrequired
    uuidstringrequired
    timestampstringrequired
    GetHotelPropertyResponse
    {
    "success": true,
    "data": {
    "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"
    }
    ]
    }
    ]
    },
    "errors": [
    "string"
    ],
    "actions": [
    "string"
    ],
    "platform": "string",
    "uuid": "string",
    "timestamp": "string"
    }