Skip to main content
GET
/
v1
/
properties
/
{property_id}
Get Property
curl --request GET \
  --url https://api.trellistech.com/v1/properties/{property_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "address": "<string>",
  "city": "<string>",
  "country": "<string>",
  "bedrooms": 123,
  "bathrooms": 123,
  "max_guests": 123,
  "status": "<string>",
  "amenities": [
    {
      "id": "<string>",
      "name": "<string>",
      "category": "<string>"
    }
  ],
  "media": [
    {
      "id": "<string>",
      "url": "<string>",
      "type": "<string>",
      "caption": "<string>"
    }
  ],
  "custom_fields": {},
  "created_at": "<string>",
  "updated_at": "<string>"
}
Returns the full details of a specific property, including amenities, media, and custom fields.

​
Path Parameters

​
property_id
string
required
The unique identifier of the property.

​
Example Request

curl -H "Authorization: Bearer trls_live_abc123..." \
  "https://api.trellistech.com/v1/properties/a1b2c3d4-5678-9abc-def0-123456789abc"

​
Response

​
id
string
Unique identifier for the property.
​
name
string
Display name of the property.
​
address
string
Full street address.
​
city
string
City name.
​
country
string
Country code (ISO 3166-1 alpha-2).
​
bedrooms
integer
Number of bedrooms.
​
bathrooms
number
Number of bathrooms.
​
max_guests
integer
Maximum guest capacity.
​
status
string
Current property status.
​
amenities
array
List of amenities available at the property.
​
media
array
Photos and videos associated with the property.
​
custom_fields
object
Key-value pairs for any custom fields configured in your workspace.
​
created_at
string
ISO 8601 timestamp of when the property was created.
​
updated_at
string
ISO 8601 timestamp of the last update.

​
Example Response

200
{
  "id": "a1b2c3d4-5678-9abc-def0-123456789abc",
  "name": "Sunset Villa",
  "address": "123 Ocean Drive",
  "city": "Miami Beach",
  "country": "US",
  "bedrooms": 3,
  "bathrooms": 2.5,
  "max_guests": 8,
  "status": "ACTIVE",
  "amenities": [
    { "id": "am-001", "name": "Pool", "category": "outdoor" },
    { "id": "am-002", "name": "WiFi", "category": "essentials" },
    { "id": "am-003", "name": "Air Conditioning", "category": "essentials" }
  ],
  "media": [
    {
      "id": "med-001",
      "url": "https://cdn.trellistech.com/properties/sunset-villa/exterior.jpg",
      "type": "photo",
      "caption": "Front view of the villa"
    }
  ],
  "custom_fields": {
    "cleaning_fee": 150,
    "pet_policy": "Dogs allowed under 30 lbs"
  },
  "created_at": "2025-06-15T10:30:00Z",
  "updated_at": "2026-03-20T14:45:00Z"
}

​
Error Responses

404
{
  "error": {
    "code": "not_found",
    "message": "No property found with the specified ID."
  }
}
401
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}