ImmobiNet
ImmobiNet API Docs - Properties

Properties (the single bookable units). Descriptions, attachments and facilities of this tag refer to the unit, not to the residence it belongs to (residence_id, see the Residences tag).


Get list of properties

GET
/api/v1/properties
basic

Returns a paginated list of properties. Fetch a single property (GET /api/v1/properties/{propertyId}) for full property information. Requires the API key scope properties:read.

Get list of properties › query Parameters

codes
​string[] · style: form

Only the properties with these codes (exact match, case-insensitive), comma-separated (codes=A1,B2). At most 50 values, more returns 400.

residence_ids
​integer[] · style: form

Only the properties of these residences (a property that belongs to any of them), comma-separated ids (residence_ids=3,7). At most 50 values, more or an invalid id returns 400.

sort_field
​string · enum
Enum values:
code
sort_order
​string · enum

If sort_field is specified but sort_order is not, the default order is 'asc'

Enum values:
asc
desc
paging_limit
​integer · min: 1 · max: 50

Limit items returned in response. Must be between 1 and 50

Default: 20
next_cursor
​string | null

Get list of properties › Responses

Get properties list


Get a property

GET
/api/v1/properties/{propertyId}
basic

Requires the API key scope properties:read.

Get a property › path Parameters

propertyId
​integer · required

Get a property › Responses

Get a property

id
​integer
code
​string

Property code

Address. Every field can be null when it is not set (or not visible to the API user); depending on the resource a field without a value is null or left out of the response.

residence_id
​integer | null

Id of the residence this property belongs to, if any

agency_id
​integer | null

Id of the agency that manages the property, null if none. The agencies of the API user are listed by GET /api/v1/agencies.

Name of the property to show, one for each language it has a title in. Empty if none is set.

registration_number
​string | null

Registration number of the property (in Italy, the CIN national identification code). null if not set or not available.

created_at
​string · date-time

Creation time of the property.

Example: 2026-06-26T14:30:00+02:00
updated_at
​string · date-time

Last modification time of the property. It changes when the property sheet or its attachments are saved in the application; changes to the rates, the availability or the reservations do not move it.

Example: 2026-06-26T14:30:00+02:00
​object

Custom fields defined by the agency (key → value), only the ones marked "Web" in the application, never the ones marked for internal use. Always present, empty object if there are none.

​CheckInOutWindow
​CheckInOutWindow
category
​string

Code of the category of the property, as listed by GET /api/v1/property-categories (which also gives its name and destination).

Example: appartamento
​PropertyComposition | null

Rooms of the property. null if not available.

​PropertyApartment | null

Apartment details. null if not available.

​PropertySurface | null

Surface of the property. null if not set.

​PropertyEnergyCertificate | null

Energy certificate, only when it has been issued. null otherwise.

​PropertyCapacity | null

Beds and maximum guests of a holiday property. null if not available.

Distances from the points of interest. Empty if there are none.


Get descriptions of a property

GET
/api/v1/properties/{propertyId}/descriptions
basic

Requires the API key scope properties:read.

Get descriptions of a property › path Parameters

propertyId
​integer · required

Get descriptions of a property › Responses

Get descriptions of a property

language
​string · pattern: ^[a-z]{2}$

Language, as an ISO 639-1 code of two lowercase letters (it, en). It names the language only, with no region.

Example: it
text
​string

Get all attachments of a property

GET
/api/v1/properties/{propertyId}/attachments
basic

Requires the API key scope properties:read.

Get all attachments of a property › path Parameters

propertyId
​integer · required

Get all attachments of a property › query Parameters

type
​string · enum

Only the attachments of this type: images (images that are not panoramic), panoramic_images or file (anything that is not an image). Omit to get all of them. Any other value returns 400.

Enum values:
images
panoramic_images
file

Get all attachments of a property › Responses

Get all attachments of a property

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object · attachment_type="file" · requires: id, mime_type, url
type = object · requires: id, mime_type, url +1 more
Properties for Variant 1:
id
​integer · required
mime_type
​string · required
url
​string · uri · required
attachment_type
​string · enum · required
Enum values:
file

Get an attachment of a property

GET
/api/v1/properties/{propertyId}/attachments/{attachmentId}
basic

Requires the API key scope properties:read.

Get an attachment of a property › path Parameters

propertyId
​integer · required
attachmentId
​integer · required

Get an attachment of a property › Responses

Get an attachment of a property

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object · attachment_type="file" · requires: id, mime_type, url
type = object · requires: id, mime_type, url +1 more
Properties for Variant 1:
id
​integer · required
mime_type
​string · required
url
​string · uri · required
attachment_type
​string · enum · required
Enum values:
file

Get facilities of a property

GET
/api/v1/properties/{propertyId}/facilities
basic

Requires the API key scope properties:read.

Get facilities of a property › path Parameters

propertyId
​integer · required

Get facilities of a property › Responses

Get facilities of a property

A facility of a residence or of a property. It refers to the catalog `GET /api/v1/facilities` by `facility`, which also gives its name in every language.
facility
​string

Code of the facility in the catalog GET /api/v1/facilities (e.g. adatto_disabili).

status
​string · enum

Whether the facility is included (included), to be paid for (paid) or not allowed (prohibited).

Enum values:
included
paid
prohibited