ImmobiNet
ImmobiNet API Docs - Contacts

Contacts

​object
​Contact[]

AddressbookEntry

type
​string · enum

email is any email address, pec the certified one, phone a landline number, mobile a mobile number.

Enum values:
email
pec
phone
mobile
value
​string

Birth

date
​string | null · date

Date of birth, YYYY-MM-DD.

city
​string | null

City of birth.

province
​string | null

Province code of the place of birth (e.g. UD).

country
​CountryCode | null · pattern: ^[A-Z]{2}$

Country of birth.

Example: IT

Contact

id
​integer
updated_at
​string · date-time

Last modification time.

Example: 2026-06-26T14:30:00+02:00
type
​string · enum
Enum values:
person
company
first_name
​string | null

First name of a person. null for companies or when the API user is not allowed to see it.

last_name
​string | null

Last name of a person. ID#<id> when the contact is anonymised for the API user. null for companies.

company_name
​string | null

Company name. null for persons or when the API user is not allowed to see it.

tax_code
​string | null

Tax code (codice fiscale) of a person or of a company. null when empty or when the API user is not allowed to see it.

vat_number
​string | null

VAT number (partita IVA) of a company. null for persons, when empty or when the API user is not allowed to see it.

​AddressbookEntry[]

Email addresses and phone numbers of the contact, one entry each, grouped by type in the order email, pec, phone, mobile (the main one of a type first). Empty when there are none or when the API user is not allowed to see them. A contact can have more than one of a type.

​object

Date and place of birth of a person. Every field is null for companies, when it is not set or when the API user is not allowed to see it.

citizenship
​CountryCode | null · pattern: ^[A-Z]{2}$

Citizenship of a person, as a country code. null for companies, when it is not set or when the API user is not allowed to see it.

Example: IT
​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.

language
​LanguageCode | null · pattern: ^[a-z]{2}$

Language to use to write to the contact. null if not set.

Example: it
​object

Custom fields defined by the agency (key → value), only the ones marked "Web" in the application, never the ones marked for internal use. Empty object if there are none or if the contact is anonymised.

CountryCode

string · pattern: ^[A-Z]{2}$

Country, as an ISO 3166-1 alpha-2 code of two uppercase letters (IT, DE).

Example: IT

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

LanguageCode

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