Schemas

Field-level detail, when available.

Position in the request array.

Per-item HTTP status.

The created or updated object, on success.

Present when the item failed.

One entry per submitted item, in request order. An item that fails while being APPLIED does not stop the others, so inspect every entry. A payload that fails schema validation is rejected whole, with a single 400.

First blocked night.

Last blocked night.

When true the final day is a check-out only, so that night stays bookable by an arriving guest.

True when your integration created this block, which is also the only case in which you may modify or delete it.

Whether the night can be booked.

BASE nightly rate in cents: the price set for this date, else the property base price. Null when the workspace has set neither in Noé (the night then keeps the price already published on the channels). Channel markups configured by the workspace are applied on top before the OTA; this is the value to read and write back.

Minimum nights for an arrival on this date: the per-date value, else the property's default minimum stay.

Maximum nights for an arrival on this date: the per-date value, else the property's default maximum stay.

Arrivals forbidden on this date.

Departures forbidden on this date.

Why the night is unavailable. Null when it is bookable.

One calendar per requested property.

Nightly price in cents, in the property currency. This is the BASE price: markup rules the workspace configured per channel still apply on top before it reaches the OTA. Below 100, or outside the property's floor/ceiling (floor_price_cents / ceiling_price_cents), the item is rejected with 422.

Minimum nights.

Maximum nights.

Forbid arrivals on these dates.

Forbid departures on these dates.

Close the dates for sale entirely.

Apply to ONE channel only, leaving the others on the all-channel value. Omit to set the value every channel inherits.

A channel-specific value always wins over the all-channel one, so setting an Airbnb price does not disturb Booking.com. To remove a channel override, set it back to the all-channel value.

Fee code, uppercase letters. Well-known codes include CLEANINGFEE.

Amount in major currency units (euros, not cents).

Display label. Informational only.

Major currency units, not cents.

Price multiplier for this channel: 1.1 adds 10% to every nightly rate published there. Send null to clear it. Note this is a MULTIPLIER, not a percentage — 10 would multiply your prices tenfold.

Guests included before the extra-guest fee applies.

Nightly fee per extra guest, in major units.

Last-minute discount, 0-100 percent.

How close to check-in the last-minute discount starts.

Fee lines to upsert.

Price multiplier for this channel: 1.1 publishes every rate 10% higher.

Property to block.

First blocked night (YYYY-MM-DD).

Last blocked night (YYYY-MM-DD), inclusive.

When true, end_date is a DEPARTURE day rather than a blocked night: the occupant leaves that morning and the date stays sellable as an arrival.

Free-form category, e.g. owner or maintenance.

Human-readable note.

HTTPS endpoint to deliver to. Must be publicly resolvable.

Event types to subscribe to. At least one.

Your own label for this endpoint.

Stable id — use it to deduplicate.

Payload version this event was shaped for.

Ids only, never a full object — fetch the resource for its current state.

The API version your responses are shaped for.

Which environment this key belongs to.

The workspace this key reads and writes.

What this key can actually do: the intersection of what Noé approved for the integration, what the workspace consented to, and what the key itself was given.

The same scopes, explained — handy for rendering a permissions screen.

Property ids you are restricted to. Null means the whole workspace, including properties added later.

The value to send as X-Noe-App.

Pass back as cursor for the next page. Null on the last page.

Floor or apartment indication, when the property has one.

One entry per date in the range.

Maximum guests.

Bed sizes, one entry per bed.

Human reference used inside Noé.

Short internal label. Often the name staff actually use.

Property type as classified in Noé.

Whether the home is a primary or secondary residence — drives local rental rules. Null when not declared in Noé (Airbnb does not supply this).

Official rental registration number, where the municipality requires one. Listing platforms are usually legally obliged to display it.

Legal cap on nights rented per year, when one applies. Null means no cap.

Video tour, when one exists.

Your own identifier for this property, if you set one.

Only present with expand=photos.

Only present with expand=owner. Personal data — handle accordingly.

Display order, ascending.

Default nightly rate in cents, used for any date without an override.

Lowest nightly rate an automated pricing tool may set, in cents.

Highest nightly rate an automated pricing tool may set, in cents.

ISO 4217 currency for every amount on this property.

Cleaning fee charged to the guest, in cents. Null when none is charged.

Default minimum nights, applied to dates without a calendar override.

Default maximum nights.

Maximum occupancy published to channels.

Nights kept closed after each check-out, for turnover.

Local check-in time (HH:mm).

Local check-out time (HH:mm).

Default nightly rate in cents, used for any date without an override.

Lowest rate an automated pricing tool may set.

Highest rate an automated pricing tool may set.

ISO 4217 currency for every amount here.

Cleaning fee charged to the guest, in cents.

Reference nightly rate published to the channels, in major units.

What applies when no date overrides it.

Per-channel overlays applied on top of whichever rate resolved.

False when the property is not connected to any channel yet. The defaults still apply; the channel overlays are empty.

When the channel overlays were last reconciled.

Property-level floor for every per-date minimum stay.

What the guest pays in total, in cents.

Accommodation portion.

Commission withheld by the channel (Airbnb host fee, Booking.com commission…), as reported by the channel. Not part of total_cents. Null when the channel did not report it.

What the channel pays out to the host: accommodation + cleaning + extra fees − channel commission. Excludes tourist tax. Same figure as the « Versement » column of the Noé billing export.

The workspace's management commission on this stay, computed with the property's commission rate and the workspace's commission basis — the same figure as the Noé billing export.

What the property owner receives: host_payout_cents − management_fee_cents.

After-the-fact changes on the channel invoice (refunds, resolution credits, price corrections), negative. 0 when none.

VAT contained in the invoice lines. Null when the channel does not send an itemised invoice (see line_items).

ISO 4217 currency of every amount above.

Where the booking came from.

The channel's own code.

Arrival date (YYYY-MM-DD).

Departure date.

Personal 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.

discount: a negative line labelled as a discount/promotion. adjustment: any other negative line (refund, resolution credit, price correction).

The channel's label.

Signed, in cents: discounts and adjustments are negative.

VAT rate in percent, as set on this invoice line.

VAT contained in amount_cents (amounts are VAT-inclusive).

Personal data: every read is audited.

Mutates data.

Display name.

Short internal label.

Official rental registration number. Listing platforms are usually legally required to display it.

Number of bedrooms.

Number of bathrooms.

Maximum guests.

Floor area in m².

Replaces the amenity list entirely. Send the full set you want.

Replaces the bed-size list entirely.

Local check-in time (HH:mm).

Local check-out time (HH:mm).

Video tour URL.

Your own identifier for this property, echoed back on reads.

Default nightly rate in cents, used for any date without an override.

Lowest nightly rate an automated pricing tool may set, in cents.

Highest nightly rate an automated pricing tool may set, in cents.

Property-level minimum stay. A FLOOR for every per-date minimum: a smaller value set through PUT /v1/calendar is capped by it.

Property-level maximum stay.

Nights closed automatically after each check-out. 0 keeps the turnover day sellable; any higher value re-closes it, so reopening that date will not hold.

Per-channel overlays: markup, occupancy pricing and fees. Only Airbnb supports them.

Replacement HTTPS endpoint.

Replaces the subscription list entirely rather than adding to it.

Your own label for this endpoint.

Set to disabled to stop delivery without deleting the endpoint.

The event this attempt delivered. Correlate it with GET /v1/events.

Attempt number, starting at 0.

HTTP status your endpoint returned.

Truncated response body.

Transport-level failure, when the attempt never got a response.

Payload version deliveries to this endpoint are shaped for.

Consecutive delivery failures. Reset by the first success.

Why Noé disabled the endpoint, when status is auto_disabled.

The new signing secret. Shown once.

Until when the PREVIOUS secret still verifies, so you can deploy without gaps.

Payload version deliveries to this endpoint are shaped for.

Consecutive delivery failures. Reset by the first success.

Why Noé disabled the endpoint, when status is auto_disabled.

Signing secret, returned ONCE at creation and never again. Store it now; verify every delivery with it.