Data Overview
Cloudbeds exposes six core entities through Coupler.io, covering the full operational picture of a hospitality property — from guest profiles and room inventory to reservations, payments, and service packages.
Entities overview
Guests
Contact details, guest history, preferences
Hotels
Property name, location, configuration, settings
Rooms
Room types, descriptions, bed types, rates, availability
Reservations
Check-in/out dates, status, source, room assignment, guest link
Transactions
Payment amounts, types, dates, reservation links
Packages
Package names, pricing, inclusions, availability
Available fields
Guests
Guest ID
Unique identifier for the guest
First name / Last name
Guest's full name
Contact email address
Phone
Contact phone number
Country
Guest's country of origin
Gender
Gender on file
Created date
When the guest profile was created
Hotels
Hotel ID
Unique property identifier
Property name
Name of the hotel or property
Address
Full property address
City / State / Country
Location details
Currency
Default billing currency
Time zone
Property time zone
Rooms
Room ID
Unique room identifier
Room name
Room label or number
Room type
Category (e.g., double, suite)
Max occupancy
Maximum number of guests
Description
Room details and amenities
Status
Active or inactive
Reservations
Reservation ID
Unique booking identifier
Guest ID
Linked guest profile
Check-in date
Scheduled arrival date
Check-out date
Scheduled departure date
Status
Confirmed, cancelled, checked-in, checked-out
Room ID
Assigned room
Source
Booking origin (direct, OTA, etc.)
Total amount
Total booking value
Adults / Children
Guest count breakdown
Transactions
Transaction ID
Unique payment identifier
Reservation ID
Linked reservation
Amount
Payment amount
Transaction type
Charge, payment, refund
Transaction date
Date the transaction occurred
Description
Line item description
Packages
Package ID
Unique package identifier
Package name
Display name
Price
Package cost
Description
What's included
Availability
Which room types it applies to
Common field combinations
Reservations + Guests — Join on Guest ID to build a full booking report with guest contact details
Reservations + Transactions — Join on Reservation ID to reconcile booking revenue against actual payments
Rooms + Reservations — Join on Room ID to analyze occupancy rates by room type
Transactions + Packages — Combine to track package revenue separately from room revenue
Use cases by role
Pull Reservations and Transactions to track RevPAR, ADR, and occupancy trends over time
Use Aggregate transformation to sum revenue by booking source or room type
Send data to Looker Studio or BigQuery for dashboarding
Export Reservations with check-in/out dates to Google Sheets for daily arrival/departure lists
Join Guests to Reservations for a complete guest profile at check-in
Use AI destinations like ChatGPT or Claude to answer natural language questions about upcoming bookings
Pull Transactions to reconcile payments and identify outstanding balances
Append transaction data from multiple properties using the Append transformation
Export to Excel or BigQuery for accounting workflows
Monitor room status and inventory using the Rooms entity
Combine Rooms with Reservations to spot availability gaps
Track package uptake by joining Packages with Reservations
Platform-specific notes
Cloudbeds uses a property-scoped API — your API key only returns data for the property it was generated under
If you manage multiple properties, you'll need a separate API key per property and can use the Append transformation to combine data across properties in a single data flow
Reservation statuses may vary slightly depending on your Cloudbeds plan and configuration
Date fields are returned in ISO 8601 format (YYYY-MM-DD)
Last updated
Was this helpful?