compare_periods
ChatGPTThe same facts for two date windows a and b (each at most 92 nights, to exclusive) and their difference b − a: nights sold, occupancy points, arrivals, cancellations, and per currency revenue (with % change), ADR and RevPAR. With by_unit, the same per active unit (up to 10). Numbers only, no interpretation. Counts as one period call.
get_availability_quote
ChatGPTWhether one stay (dates, guests, pet, extras) can be sold on one unit, or on the active units up to this connection's limit, and the price the booking engine would charge: total, taxes, fees and discounts. Restrictions and unavailable units are explained. room_subtotal_cents is already net of any promotion; discount_cents is shown for information and must not be subtracted again. This is a quote only: nothing is reserved.
get_booking_pace
ChatGPTFor one upcoming window (starting today or later, at most 92 nights, to exclusive): nights, bookings, occupancy and revenue already on the books now, 7 days ago and 30 days ago; pickup over the last 7 and 30 days (bookings and nights added, cancelled, net); and the same window last year (364 days earlier, same weekdays) as it stood at the same lead time and as it finished. Bookings already made only: no projection. Counts as one period call.
get_booking_summary
ChatGPTOne booking by its 8-character reference: dates, unit, status, party size, money (total, paid, balance) and the payment timeline (type and method class only). Where this connection allows it, a guest-name search over a check-in range of at most 31 days returns up to 5 bookings. No contact data. Guest names and notes are returned only when guest text is switched on for the whole Maki Beds service (one server-wide setting, not per property; off unless stated), and then notes are marked as text written by the guest; otherwise they are withheld. The ref is the reference printed in the guest's confirmation email (use it to find the guest's thread in the owner's mailbox).
get_insight_report
ChatGPTA ready-made report of up to 12 months (from_month YYYY-MM, months, lang en or es): labelled facts (nights, occupancy, arrivals, stay length, lead time, cancellations, revenue, ADR, RevPAR per currency), month, unit and channel tables, Vega-Lite chart specs, and one self-contained HTML page (no scripts) that can be shown or saved as is. Facts only. Counts as one period call.
get_management_recommendations
ChatGPTThe open recommendations Maki Beds already prepared for this property: how many are open and, where this connection includes them, up to 5 cards (kind, title, summary, the nights they concern). It never runs a new analysis.
get_operational_status
ChatGPTCounts of what needs attention now: arrivals in the next 7 days and how many still owe a balance (or have an unknown balance), open and urgent maintenance tickets, open guest reports, and conversations waiting for a person. Counts only.
get_pending_payments
ChatGPTConfirmed and in-house stays that still owe money: totals per currency (never mixed), how many stays have an unknown total or paid amount, and the 10 soonest by due date (final payment date, else check-in) with reference, unit, dates and balance. No guest names. The ref is the reference printed in the guest's confirmation email (use it to find the guest's thread in the owner's mailbox).
get_period_summary
ChatGPTFacts for one date window (to is exclusive): nights sold, occupancy, arrivals, cancellations and revenue per currency (gross, paid, outstanding). The window this connection allows (from the current month up to 92 nights within 24 months of history) is stated when a request falls outside it. A few calls per day.
get_today_movements
ChatGPTToday's movements at the property, in the property's own timezone: counts of arrivals due, arrivals already checked in, tentative holds (not confirmed), departures due, departures done and guests in house, plus up to 30 booking rows (short reference, unit, nights, party size, status, payment status, balance due). No guest names or contact data. The ref is the reference printed in the guest's confirmation email (use it to find the guest's thread in the owner's mailbox).
get_trends
ChatGPTMonth-by-month facts for up to 12 consecutive months (from_month YYYY-MM): nights available and sold, occupancy, arrivals, average length of stay, median lead time, cancellations, lapsed unpaid holds, and per currency revenue, ADR and RevPAR; plus, over the whole span, occupancy by day of week, channel mix, lead-time and length-of-stay splits. Facts only, within the history this connection covers (stated when a request falls outside it). Counts as one period call.
get_upcoming_arrivals
ChatGPTConfirmed stays checking in from today through the next 6 days (org local time): reference, unit, dates, nights, number of guests, payment status and balance (null when unknown). Up to 30 rows, depending on this connection. No guest names. The ref is the reference printed in the guest's confirmation email (use it to find the guest's thread in the owner's mailbox).
list_open_tickets
ChatGPTOpen and scheduled maintenance tickets, newest first, 10 per page and up to 3 pages: reference, unit, title (marked as text written by staff or a guest), urgency, status and age in days. Pass next_cursor for the next page.
quote_stay_options
ChatGPTUp to 8 alternative stays for the same party (for example every weekend of a month) in one call: for each stay, which units can be sold and the total the booking engine would charge, or why not. Use it instead of many get_availability_quote calls; each stay counts as one quote toward the daily allowance. At most 24 stay × unit combinations per call (pass unit_id to check more stays on one unit). Totals are in the minor units of the currency. A quote only: nothing is reserved.