Properties

Properties are the core of the Filoxenos platform. Each property represents a physical short-term rental unit (e.g., an apartment or villa) that you manage and report to AADE.

GET/properties

Returns a list of all properties associated with your account.

Scoperead

Response Fields

Parameter Type Description

id

uuid

Unique identifier for the property.

name

string

Internal name of the property.

ama_number

string

The official AADE AMA (Short-term Rental Registry Number).

property_type

enum

Type of property (APARTMENT, VILLA, HOUSE, ROOM).

square_meters

integer

Total surface area of the property.

checkin_slug

string

Unique slug used for generating digital check-in links.

channel_manager

object

Connection details for the linked channel manager.

`provider`	string	e.g., Smoobu, Guesty, or Manual.
`external_id`	string	The ID of the property in the provider system.

Example Response

json

[
  {
    "id": "prop_12345",
    "name": "Athens Loft - Koukaki",
    "ama_number": "123456789",
    "property_type": "APARTMENT",
    "square_meters": 55,
    "checkin_slug": "athens-loft-koukaki",
    "channel_manager": {
      "provider": "Smoobu",
      "external_id": "98765"
    }
  },
  {
    "id": "prop_67890",
    "name": "Island View Villa - Mykonos",
    "ama_number": "987654321",
    "property_type": "VILLA",
    "square_meters": 120,
    "checkin_slug": "island-view-mykonos",
    "channel_manager": {
      "provider": "Guesty",
      "external_id": "44556"
    }
  }
]

GET/properties/:id

Retrieves the details of a specific property.

Scoperead

PATCH/properties/:id

Updates metadata for an existing property.

Scopewrite

Request Body

Parameter	Type	Description
`ama_number`	string	The 9-digit registration number.
`property_type`	enum	APARTMENT \| VILLA \| HOUSE \| ROOM
`square_meters`	integer	Positive integer values only.
`checkin_slug`	string	Must be unique across your properties.