Bookings

Manage reservations for your properties. Bookings are either synced from external channel managers or created manually via the API.

GET/bookings

Returns a paginated list of bookings.

Scoperead

Query Parameters

Parameter	Type	Description
`property_id`	uuid	Filter by specific property ID.
`date_from`	date	Filter bookings arriving after this date (ISO 8601).
`date_to`	date	Filter bookings arriving before this date (ISO 8601).
`channel`	string	Filter by channel name (e.g., Airbnb, Booking.com).
`status`	enum	CONFIRMED \| CANCELLED \| PENDING
`page`	integer	Page number for pagination (default: 1).
`limit`	integer	Number of results per page (default: 20, max: 100).

Example Response

json

{
  "data": [
    {
      "id": "book_abc123",
      "property_id": "prop_12345",
      "guest_name": "Yiannis Papadopoulos",
      "check_in": "2026-06-15",
      "check_out": "2026-06-20",
      "nights": 5,
      "channel": "Airbnb",
      "total_price": 750,
      "status": "CONFIRMED"
    }
  ],
  "meta": {
    "total_count": 145,
    "page": 1,
    "limit": 20
  }
}

POST/bookings

Creates a manual booking for a property.

Scopewrite

Request Body

Parameter	Type	Description
`property_id`Required	uuid	ID of the property for this booking.
`guest_name`Required	string	Full name of the primary guest.
`check_in`Required	date	Check-in date (YYYY-MM-DD).
`check_out`Required	date	Check-out date (YYYY-MM-DD).
`total_price`	number	Total amount paid for the stay.
`notes`	string	Internal booking notes.

Validation Rules

Check-out date must be after the check-in date.
The property must belong to the authenticated user.
Manual bookings are automatically marked as CONFIRMED.