Skip to main content
GET
/
v1
/
reservations
/
{reservation_id}
Get Reservation
curl --request GET \
  --url https://api.trellistech.com/v1/reservations/{reservation_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "property_id": "<string>",
  "property_name": "<string>",
  "guest": {
    "name": "<string>",
    "email": "<string>",
    "phone": "<string>"
  },
  "check_in": "<string>",
  "check_out": "<string>",
  "nights": 123,
  "guests": 123,
  "source": "<string>",
  "status": "<string>",
  "financials": {
    "total_amount": 123,
    "nightly_rate": 123,
    "cleaning_fee": 123,
    "currency": "<string>"
  },
  "custom_fields": {},
  "notes": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}
Returns the full details of a specific reservation, including guest contact information, property details, financial summary, and any custom fields.

​
Path Parameters

​
reservation_id
string
required
The unique identifier of the reservation.

​
Example Request

curl -H "Authorization: Bearer trls_live_abc123..." \
  "https://api.trellistech.com/v1/reservations/r1a2b3c4-5678-9abc-def0-111111111111"

​
Response

​
id
string
Unique identifier for the reservation.
​
property_id
string
ID of the associated property.
​
property_name
string
Name of the associated property.
​
guest
object
Primary guest contact information.
​
check_in
string
Check-in date (ISO 8601).
​
check_out
string
Check-out date (ISO 8601).
​
nights
integer
Total number of nights.
​
guests
integer
Number of guests.
​
source
string
Booking source (e.g., “Airbnb”, “Booking.com”, “Direct”).
​
status
string
Current reservation status.
​
financials
object
Financial breakdown for the reservation.
​
custom_fields
object
Key-value pairs for any custom fields configured in your workspace.
​
notes
string
Internal notes about the reservation.
​
created_at
string
ISO 8601 timestamp of when the reservation was created.
​
updated_at
string
ISO 8601 timestamp of the last update.

​
Example Response

200
{
  "id": "r1a2b3c4-5678-9abc-def0-111111111111",
  "property_id": "a1b2c3d4-5678-9abc-def0-123456789abc",
  "property_name": "Sunset Villa",
  "guest": {
    "name": "Maria Garcia",
    "email": "maria.garcia@example.com",
    "phone": "+1-555-0123"
  },
  "check_in": "2026-04-10",
  "check_out": "2026-04-15",
  "nights": 5,
  "guests": 4,
  "source": "Airbnb",
  "status": "CONFIRMED",
  "financials": {
    "total_amount": 1250.00,
    "nightly_rate": 220.00,
    "cleaning_fee": 150.00,
    "currency": "USD"
  },
  "custom_fields": {
    "special_requests": "Early check-in requested",
    "parking_pass": true
  },
  "notes": "Returning guest, third stay this year.",
  "created_at": "2026-03-01T08:00:00Z",
  "updated_at": "2026-03-15T12:30:00Z"
}

​
Error Responses

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