Reservations
Bookings from every channel, and optionally guest identity. Read-only: the channel is the source of truth.
List reservations
Returns reservations, most recently modified first. expand=guest embeds guest identity and requires the reservations:guest_read scope; without it the guest field is omitted and the request still succeeds.
query Parameters
idsComma-separated list of resource ids to fetch.
created_afterOnly records created strictly after this instant (RFC 3339).
created_beforeOnly records created strictly before this instant (RFC 3339).
updated_afterOnly records modified strictly after this instant (RFC 3339). Use this for delta syncs.
updated_beforeOnly records modified strictly before this instant (RFC 3339).
limitPage size, 1-200.
cursorOpaque cursor from a previous response. Pass pagination.next_cursor back verbatim.
property_idOnly reservations for this property.
statusFilter by reservation status.
channelFilter by booking channel.
checkin_fromCheck-in on or after this date.
checkin_toCheck-in on or before this date.
checkout_fromCheck-out on or after this date.
checkout_toCheck-out on or before this date.
expandComma-separated related objects to embed. Allowed: guest, property, line_items. Embedding guest requires the reservations:guest_read scope; without it the field is omitted and the request still succeeds.
Headers
X-Noe-AppYour integration key. Verified against the key you authenticated with; a mismatch is rejected.
List reservations › Responses
A cursor-paginated page of reservations.
Retrieve a reservation
Returns a single reservation.
path Parameters
idReservation id.
query Parameters
expandComma-separated related objects to embed. Allowed: guest, property, line_items.
Headers
X-Noe-AppYour integration key. Verified against the key you authenticated with; a mismatch is rejected.
Retrieve a reservation › Responses
The requested reservation.
idobjectproperty_idstatuschannelWhere the booking came from.
confirmation_codeThe channel's own code.
check_inArrival date (YYYY-MM-DD).
check_outDeparture date.
nightsguests_countcurrencybooked_atcancelled_atcreated_atupdated_atPersonal data. Present only when your key holds reservations:guest_read; otherwise the field is absent entirely rather than nulled. Every read is recorded in an audit trail.
Only present with expand=property.
Only present with expand=line_items. The channel invoice, line by line (discounts and adjustments included, payments excluded). Null when the channel does not send an itemised invoice — Airbnb sends a single net-payout line, so Airbnb stays are never itemised; use amounts for them.