ImmobiNet
ImmobiNet API Docs - Properties

Residences

​object
​Residence[]

Residence

id
​integer

Name of the residence to show. Residences are not translated yet, so it has one entry, in Italian (it); more languages will be added when they are. Always present.

code
​string

Code of the residence, always present. It is not guaranteed to be unique, so use id to refer to a residence. Use the codes query parameter of the list to find the residences with a code.

type
​string

Code of the type of the residence, as listed by GET /api/v1/residence-types (which also gives its name). Omitted when the residence has no type.

Example: residence
​object

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.

property_ids
​integer[]

Ids of the properties of the residence visible to the API user, in ascending order. Always present, empty when none is visible.

​object

Reserved for custom fields (key → value). Custom fields are not available for residences yet, so it is always an empty object.

ResidenceType

code
​string

Code of the residence type, the value of type of the residences (e.g. residence).

name
​string

Name of the residence type, to show (e.g. Residence turistico).

Facility

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

FacilityItem

A facility of the catalog.
code
​string

Code of the facility, the value of facility of the facilities of residences and properties (e.g. adatto_disabili).

Name of the facility to show, one for each language of the installation.

PropertyListItem

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.

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.

PropertyCategory

code
​string

Code of the category, the value of category of the properties (e.g. appartamento).

name
​string

Name of the category, to show (e.g. Appartamento).

destination
​string · enum

Use of the properties of the category.

Enum values:
residential
commercial
holiday

PropertyComposition

bathrooms
​integer | null
bedrooms
​integer | null
rooms
​integer | null
balconies
​integer | null
terraces
​integer | null

PropertyApartment

floor
​string | null

Description of the floor.

elevators
​integer | null
total_floors
​integer | null
unit_number
​string | null

PropertySurface

value
​number
unit
​string

PropertyEnergyCertificate

class
​string | null
performance_index
​number | null

Energy performance index, in kWh/m² per year.

PropertyCapacity

type
​string | null
max_guests
​integer | null
double_beds
​integer | null
single_beds
​integer | null
sofa_beds
​integer | null
bunk_beds
​integer | null

PropertyPointOfInterestDistance

code
​string

Code of the point of interest.

distance_meters
​number

Distance of the property from the point of interest, in metres.

CheckInOutWindow

from
​string | null · time
to
​string | null · time

TranslatedText

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

Attachment

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

FileAttachment

id
​integer · required
mime_type
​string · required
url
​string · uri · required
attachment_type
​string · enum · required
Enum values:
file

ImageAttachment

id
​integer · required
mime_type
​string · required
url
​string · uri · required
attachment_type
​string · enum · required
Enum values:
file
image
panoramic_images
​ImageMetadata · required

ImageMetadata

file_size
​integer · required

File size in bytes

width
​integer · required

Image width in pixels

height
​integer · required

Image height in pixels

AttachmentType

code
​string

Code of the attachment type.

name
​string

Name of the attachment type, to show.

DatetimeRome

string · date-time

Instant in RFC 3339 format, in Europe/Rome timezone, with the UTC offset (e.g. 2026-06-26T14:30:00+02:00).

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