Skip to main content
GET
Read one property connected to your PMS

Authorizations

Authorization
string
header
required

A PMS credential issued by Tatallo: an opaque key of the form tat_<env>_sk_…, where <env> is stg on staging and live on production. A key works only in its own environment. Send it as Authorization: Bearer <key>, from your servers only.

Path Parameters

propertyId
string<uuid>
required

The property's id, as listed by GET /v1/properties.

Response

The property.

id
string<uuid>
required

The property's permanent, opaque identifier. Store it once in your mapping table: it never changes meaning. It is an identifier, not a credential: knowing it grants nothing.

name
string
required

The property's name on Tatallo.

timezone
string | null
required

The IANA time zone of the property (for example Europe/Rome). Interpret stay dates and check-in times in it. May be null only while the property is pending.

Example:

"Europe/Rome"

status
enum<string>
required

Whether the property can sell: active can; inactive was suspended and cannot; pending is not live yet.

Available options:
active,
inactive,
pending
country
string
required

The property's country, by name.

city
string
required
max_guests
integer
required

The most guests the property sleeps.

Required range: x >= 1
currency
string
required

The property's currency, ISO 4217.

Pattern: ^[A-Z]{3}$
updated_at
string<date-time>
required

When the property last changed, ISO 8601 in UTC.