API Responses

Response Schemas

Facts Sheet Response

The top-level response is an array of property objects:

[
  {
    "property_id": "abc123",
    "property_name": "Grand Resort Antalya",
    "property_type": "resort",
    "published_at": "2026-04-15T10:22:00Z",
    "main_info": {
      "address": "Lara Beach Road, No 12, Antalya",
      "country": "TR",
      "city": "Antalya",
      "latitude": 36.8585,
      "longitude": 30.7014,
      "stars": 5,
      "check_in": "14:00",
      "check_out": "12:00",
      "min_age": 0,
      "total_rooms": 320,
      "year_built": 2005,
      "last_renovation": 2022,
      "primary_email": "info@grandresort.com"
    },
    "environment": { ... },
    "facilities": { ... },
    "rooms": [ ... ],
    "food_beverage": { ... },
    "all_inclusive": { ... },
    "children": { ... },
    "entertainment": { ... },
    "sports_wellness": { ... },
    "additional_info": { ... },
    "maintenance": { ... },
    "partner_hotel": { ... }
  }
]

Photos Response

[
  {
    "property_id": "abc123",
    "property_name": "Grand Resort Antalya",
    "photos": [
      {
        "photo_id": "ph_001",
        "category": "exterior",
        "is_primary": true,
        "url": "https://cdn.hotelfacts.net/photos/hashed-url/original.jpg",
        "url_medium": "https://cdn.hotelfacts.net/photos/hashed-url/medium.jpg",
        "url_thumb": "https://cdn.hotelfacts.net/photos/hashed-url/thumb.jpg",
        "caption": "Main entrance",
        "uploaded_at": "2026-03-10T08:00:00Z"
      }
    ]
  }
]

Stop Sale Response

[
  {
    "property_id": "abc123",
    "property_name": "Grand Resort Antalya",
    "rooms": [
      {
        "room_id": "rm_101",
        "room_name": "Standard Double Sea View",
        "calendar": [
          { "date": "2026-06-01", "status": "stop_sale" },
          { "date": "2026-06-02", "status": "stop_sale" },
          { "date": "2026-06-15", "status": "on_request" }
        ]
      }
    ]
  }
]

Status Values

Value	Meaning
stop_sale	Room blocked — no new bookings.
open_sale	Room explicitly confirmed available.
on_request	Availability unconfirmed — request before booking.
blocked	Internal block (maintenance, owner stay).

Days not present in the calendar array have no explicit status set (default availability).