ImmobiNet

Developer documentation

Immobinet API

REST API of ImmobiNet, the property management system (PMS) for holiday rentals and other accommodation businesses. It exposes the data of an agency's installation: properties and residences, availability and rates, reservations, guests, quotes, invoices, cash transactions, contacts and messages.

What you can do

The API is mostly read only. Writing is limited to revenue prices, the replies to messages (drafts, attachments and sending) and the attachments of the residences. It replaces the read operations of the ImmobiNet SOAP web service; the migration table is in the Auth page.

Authentication

Every request uses HTTP Basic authentication with the credentials of an API user of the installation (Authorization: Basic ...). Call GET /api/v1/token to see the expiry and the scopes of the key in use, and GET /api/v1/users/me to see the current user.

  • A wrong key returns 401.
  • The user needs the webservice privilege, otherwise the API answers 403. Each resource adds its own privileges and visibility rules, described in its page.
  • A key can only call the operations covered by its scopes (<resource>:<action>, e.g. reservations:read).
  • If the user has a webservice configuration, only the properties enabled for it are visible.
curl -u "<user>:<key>" -H "Accept: application/json" \
  "https://<your-immobinet-host>/api/v1/token"

Base URL and conventions

All paths start with /api/v1. The specs do not declare a servers entry: use the host of your ImmobiNet installation.

  • Date-times are RFC 3339 with an explicit offset, in the Europe/Rome timezone (e.g. 2026-06-26T14:30:00+02:00).
  • Amounts are decimal numbers in euro (e.g. 120.5), not cents.
  • Lists are paginated with a cursor: pass _pagination.next_cursor as next_cursor until it is null.
  • To stay in sync, poll the lists (where available with updated_since) or receive PUSH change notifications and then read the changed items; see the Polling and Change notifications sections of the Auth page.

API reference