Enquiries Channel manager Bookings Your website Booking engine Pricing Log in Sign up
v2026-09

booking.changed

A booking you created has changed — by you or by the host.

When it fires

A booking you created changed — either the host edited it in the Doorloom app, or your own write is being echoed back to you as confirmation.

This event describes a thing rather than a period, so window is null.

What to do with it

  • This event reaches only the integration that owns the booking. It carries guest contact details, so it is never broadcast to other integrations covering the same property.
  • There is no separate created, updated or cancelled event. A cancellation arrives as booking.changed with status: "cancelled" and a non-null cancelled_at.
  • origin tells you who made this change. "partner" is your own write coming back — you can usually ignore it, or use it to confirm the write landed. "doorloom" is the host editing in the app, which you must apply.
  • revision increments on every change from either side. It is what If-Match compares against on PATCH /bookings/{id}.
  • The event is sent when one of these changes: status, check_in, check_out, pricing.total, pricing.advance, cancelled_at, the guest counts, the allocated unit, guest.name or guest.mobile. A change to only billing, guest.email, pricing.currency, notes, source.reference, or a payment the host records later (which moves pricing.balance) does not send one. Your own PATCH still returns the new state in its response. A host-side edit to the billing details, email or note shows up when you poll GET /bookings?updated_since=. A host-recorded payment does not move updated_at either, so read the booking by id when you need its current balance.
  • Creating a booking sends no booking.changed. The 201 is your confirmation.
  • data here is byte-identical to the booking object returned by the REST endpoints, so one parser serves both.

The data block

Field Type Description
id integer Doorloom's booking id. Use it in the REST paths.
external_booking_id string|null The id you supplied at create.
external_reference string|null Your source.reference, e.g. the OTA confirmation code.
revision integer Increments on every change, from either side.
origin string "partner" or "doorloom" — who made the latest change.
status string pending, confirmed, cancelled, completed or refunded.
property.doorloom_id integer The booked property.
property.external_id string|null Your alias for it.
check_in string Y-m-d.
check_out string Y-m-d. Exclusive — the guest leaves this morning.
guests.adults integer Total adults across all units.
guests.children integer Total children across all units.
guest.name string Lead guest name.
guest.phone_code string Dialling code, e.g. "+91".
guest.mobile string Mobile number without the dialling code.
guest.email string|null Guest email, if one was given.
billing.gstin string|null The guest's GSTIN, for a business guest.
billing.company_name string|null The guest's company name.
billing.address string|null The guest's billing address.
units[].property object {doorloom_id, external_id} for the unit's property.
units[].inventory_id integer The allocated unit.
units[].external_unit_id string|null Your alias for it.
units[].adults integer Adults in this unit.
units[].children integer Children in this unit.
units[].meal_plan string|null EP, CP, MP or AP.
units[].stay_price number Money for this unit across the stay: the stay_price you sent, or an even share of total if you sent none.
units[].meal_total number Meal money for this unit across the stay. 0 on a booking you wrote, because the meal plan you send is a label and its price is inside stay_price. Non-zero only if the host re-priced the booking in the app.
units[].line_total number stay_price plus meal_total.
pricing.currency string ISO 4217 code of the pricing amounts: the pricing.currency you sent, or "INR" if you sent none.
pricing.total number Booking total. For a booking you created, this is the total you sent.
pricing.advance number Recorded as collected.
pricing.balance number Still owed: total minus every payment on the booking, yours and any the host recorded.
pricing.gst.mode string|null inclusive (GST is inside total), exclusive (added on top, host-priced bookings only) or none. null on older bookings, whose GST follows the host's settings.
pricing.gst.amount number The GST inside total. 0 when none applies.
pricing.partner_breakdown object|null The whole pricing object you sent (total, currency, includes_gst and breakdown), stored as sent. A PATCH that sends pricing merges its keys into it. Your own breakdown is at pricing.partner_breakdown.breakdown and is never interpreted.
payment object|null The payment object you sent, stored as sent. A PATCH that sends payment merges its keys into it.
source.channel string|null The channel you named at create, e.g. "airbnb".
source.reference string|null Your reference on that channel.
notes string|null Free-text note on the booking.
cancelled_at string|null ISO-8601 with an offset, in UTC. Non-null once cancelled.
cancellation_note string|null Why it was cancelled.
created_at string ISO-8601 with an offset, in UTC.
updated_at string ISO-8601 with an offset, in UTC.

Example

The full envelope, as it arrives on the wire.

json
{
    "id": "01J6Y0W1T4V7Y9B1D3F5H7J9K1",
    "type": "booking.changed",
    "version": "2026-09",
    "sequence": 1047,
    "occurred_at": "2026-10-01T10:52:40+00:00",
    "integration": {
        "id": 12,
        "slug": "acme-pms"
    },
    "property": {
        "doorloom_id": 902,
        "external_id": "VILLA-9",
        "master_property_id": 902
    },
    "window": null,
    "data": {
        "id": 55231,
        "external_booking_id": "PMS-100234",
        "external_reference": "HM-77",
        "revision": 2,
        "origin": "doorloom",
        "status": "confirmed",
        "property": {
            "doorloom_id": 902,
            "external_id": "VILLA-9"
        },
        "check_in": "2026-10-12",
        "check_out": "2026-10-14",
        "guests": {
            "adults": 4,
            "children": 1
        },
        "guest": {
            "name": "Asha Rao",
            "phone_code": "+91",
            "mobile": "9876543210",
            "email": "[email protected]"
        },
        "billing": {
            "gstin": "29AAACA1234A1ZG",
            "company_name": "Acme Travels Pvt Ltd",
            "address": "12 MG Road, Bengaluru"
        },
        "units": [
            {
                "property": {
                    "doorloom_id": 902,
                    "external_id": "VILLA-9"
                },
                "inventory_id": 31,
                "external_unit_id": "ROOM-A",
                "adults": 2,
                "children": 1,
                "meal_plan": "CP",
                "stay_price": 10600,
                "meal_total": 0,
                "line_total": 10600
            },
            {
                "property": {
                    "doorloom_id": 902,
                    "external_id": "VILLA-9"
                },
                "inventory_id": 32,
                "external_unit_id": "ROOM-B",
                "adults": 2,
                "children": 0,
                "meal_plan": "EP",
                "stay_price": 8000,
                "meal_total": 0,
                "line_total": 8000
            }
        ],
        "pricing": {
            "currency": "INR",
            "total": 18600,
            "advance": 4000,
            "balance": 14600,
            "gst": {
                "mode": "inclusive",
                "amount": 885.72
            },
            "partner_breakdown": {
                "total": 18600,
                "currency": "INR",
                "includes_gst": true,
                "breakdown": {
                    "room": 16000,
                    "meals": 2600
                }
            }
        },
        "payment": {
            "status": "partial",
            "amount_collected": 4000,
            "collected_by": "partner",
            "reference": "pay_123"
        },
        "source": {
            "channel": "airbnb",
            "reference": "HM-77"
        },
        "notes": "Late arrival, around 11pm",
        "cancelled_at": null,
        "cancellation_note": null,
        "created_at": "2026-10-01T10:28:12+00:00",
        "updated_at": "2026-10-01T10:52:40+00:00"
    }
}

Related

Something unclear or wrong on this page? Write to [email protected] and tell us which page — we would rather fix the doc than answer the ticket twice.