ImmobiNet
ImmobiNet API Docs - Reservations

ImmobiNet API Docs - Reservations

PMS ImmobiNet - Reservations (read only).

Visibility: the API returns only the reservations the API user can see in the application. The customer is given only as contact_id: the personal data are in /api/v1/contacts, with their own visibility rules. When the API user has a webservice configuration, only the reservations of the properties enabled for that configuration are returned.

Polling: use updated_since and follow _pagination.next_cursor. Items are ordered by updated_at, then by id. Reservations deleted or cancelled in the application stay in the list with status: deleted and deleted_at: cancelling a reservation in the application (cancelled, cancelled with a penalty, owner hold, to be handled) sets deleted_at, so it is reported as deleted. updated_at is set when the change is saved, slightly before it becomes visible: a reservation saved while you were reading can appear later with a updated_at older than the newest one you have seen. Start each poll from the highest updated_at you have seen minus a margin (e.g. a few minutes) and skip the items whose id and updated_at you have already processed. guest_area_urls depends on the current time too (the agency can block the guest area after arrival or departure): it can become null without the reservation appearing again in updated_since, so don't store it, read the reservation when you need the link.

Filters: the list can be narrowed by arrival (arrival_from, arrival_to) and departure (departure_from, departure_to) day, both inclusive and in YYYY-MM-DD format, and by property (property_ids, or property_codes for the codes of the properties, which the reservation does not carry: read them from /api/v1/properties). Filters combine with each other and with updated_since (all must match) and never show reservations the API user cannot see. A from after its to returns 400. A cursor is valid for the same filters it was issued with.

Change notifications: ImmobiNet can call a URL of yours when a reservation changes (ModAgenzia/Prenotazione and ModAgenzia/StatoPrenotazione events, and ModAgenziaInquilini/Inquilino for its guests): see "Change notifications (PUSH)" in the Authorization page.

Optional fields: fields that are not available to every installation (e.g. guest_area_urls) are always present and null when not available or without a value. custom_fields is always present (empty object if there are none).

Prices: amounts are decimal numbers in euro (e.g. 120.5).

Timezone: all date-time values are in the Europe/Rome timezone (RFC 3339 with explicit offset, e.g. 2026-06-26T14:30:00+02:00).

Security Schemes
basicAuth
HTTP basic
http