Noé Public API

The Noé Public API gives approved integrations programmatic access to a conciergerie workspace: properties, reservations, availability blocks and the pricing calendar.

Authentication

Send your key as Authorization: Bearer noe_live_.... Keys are issued by the workspace owner from Mon compte → API and can be revoked at any time. Include X-Noe-App: <your-integration-key> so a key used by the wrong system fails loudly rather than silently succeeding.

Scopes

Every endpoint declares the scope it needs. What a key can actually do is the intersection of three layers, each of which can only narrow the last: what Noé approved for your integration, what the workspace consented to, and what the individual key was given. A grant may also be restricted to a subset of the workspace’s properties.

Pagination

List endpoints are cursor-paginated. Pass pagination.next_cursor back as cursor to get the next page. Combine updated_after with the cursor to run an incremental sync rather than re-reading everything — that is the single most effective way to stay inside your rate limit.

Rate limits

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. On 429 a Retry-After header tells you how long to wait. Writes have their own, tighter budget.

Idempotency

Every write requires an Idempotency-Key header. Retrying with the same key replays the original response instead of performing the write twice, which makes a timeout safe to retry.

Errors

Errors return { "error": { "code", "message", "details", "request_id" } }. Quote the request_id when contacting support and we can find the exact request in our logs.