Properties

What a property is in the Tatallo PMS API, field by field.

A property is a place a host offers on Tatallo: an apartment, a house, a hotel. Through the Tatallo PMS API your PMS sees only the properties your hosts have connected to it.

A property is not necessarily one room or one unit. A house is one place, while a hotel has many rooms under one property. The Tatallo PMS API v1 doesn’t expose units yet (see the roadmap), so map a property only to the listing in your PMS it corresponds to, and don’t assume a grain Tatallo hasn’t promised.

Fields

Field	Type	Meaning
id	UUID	The property’s opaque, permanent identifier. Store it once in your mapping table: it never changes meaning, even as Tatallo adds features. It is an identifier, not a credential: knowing it grants nothing.
name	string	The property’s name on Tatallo, to help you confirm you are mapping the right listing.
timezone	string or null	The property’s IANA time zone, for example Europe/Rome. Interpret stay dates and check-in times in it. It is null only while the property is pending.
status	active, inactive or pending	Whether the property can sell (below).
country	string	The property’s country, by name.
city	string	The property’s city.
max_guests	integer	The most guests the property sleeps.
currency	string	The property’s currency, ISO 4217 (for example EUR).
updated_at	string	When the property last changed, ISO 8601 in UTC.

Nothing else about a property is shared. In particular, the API never exposes its address, coordinates, prices, house rules or the host’s contact details.

Status

status	Meaning
active	Live on Tatallo: guests can book it.
inactive	Suspended: guests cannot book it for now.
pending	Not live yet: still being set up.

New statuses are never added silently: a change to this list follows the versioning policy of /v1.

Which properties you see

A property is visible to your PMS credential only once its host has connected that property to your PMS. A property that isn’t connected, was removed, or never existed answers 404 property_not_found, the same in every case. When a host disconnects a property, or pauses their connection to your PMS, it disappears from your list and answers 404 from the next request.