GET /properties — список объектов

Возвращает объекты недвижимости текущего тенанта с фильтрацией и пагинацией.

Бизнес-описание процесса: Управление объектами

Доступ

Требуется API-ключ. Возвращаются только объекты тенанта.

Параметры запроса

Параметр	Тип	По умолчанию	Описание
status_id	integer	—	Фильтр по статусу объекта
property_type	string	—	Фильтр по типу объекта
deal_type	string	—	Фильтр по типу сделки
city_id	integer	—	Фильтр по городу
limit	integer	50	Количество результатов (1–100)
offset	integer	0	Смещение для пагинации

Все параметры опциональны. Без фильтров возвращаются все объекты тенанта.

Ответ

{
  "items": [
    {
      "id": 42,
      "property_type": "Квартира",
      "deal_type": "Продажа",
      "price": 150000.00,
      "status_id": 5,
      "status_name": "published",
      "city": { "id": 1, "name": "Лимассол" },
      "district": { "id": 5, "name": "Центр" },
      "area": 85.5,
      "rooms": 3,
      "created_at": "2026-02-10T14:30:00+00:00",
      "updated_at": "2026-02-12T09:15:00+00:00"
    }
  ],
  "total": 12,
  "limit": 50,
  "offset": 0
}

Поля объекта

Поле	Тип	Описание
id	integer	ID объекта
property_type	string	Тип объекта
deal_type	string	Тип сделки
price	decimal | null	Цена
status_id	integer	ID статуса
status_name	string	Название статуса
city	object	Город (id, name)
district	object | null	Район
area	decimal | null	Площадь (м²)
rooms	integer | null	Количество комнат
created_at	datetime	Дата создания
updated_at	datetime	Дата последнего обновления

401 Unauthorized

{ "detail": "Invalid or missing API key" }