ImmobiNet
ImmobiNet API Docs - Contacts

Retrieve contacts

GET
/api/v1/contacts
basic

Returns a paginated list of the contacts visible to the API user, ordered by updated_at and id ascending. Requires the API key scope contacts:read.

Retrieve contacts › query Parameters

updated_since
​string

Returns only the items modified at or after this instant. ISO 8601 date-time with an explicit offset (e.g. 2026-01-31T10:00:00+01:00 or 2026-01-31T09:00:00Z; URL-encode the + as %2B). It cannot be in the future: an invalid or future value returns 400.

Example: 2026-01-31T10:00:00+01:00
paging_limit
​integer · min: 1 · max: 50

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

Default: 20
next_cursor
​string | null

Retrieve contacts › Responses

Successful response

​object
​Contact[]

Retrieve a single contact

GET
/api/v1/contacts/{contactId}
basic

Requires the API key scope contacts:read.

Retrieve a single contact › path Parameters

contactId
​integer · required

Retrieve a single contact › Responses

Contact found

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.