> ## Documentation Index
> Fetch the complete documentation index at: https://tatallo-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

> [!NOTE]
>
> 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](https://tatallo-docs.mintlify.site/platform/versioning.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.