Contacts
Retrieve contacts
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.
query Parameters
updated_sinceReturns 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.
paging_limitLimit items returned in response. Must be between 1 and 50
next_cursorRetrieve contacts › Responses
Retrieve a single contact
Requires the API key scope contacts:read.
path Parameters
contactIdRetrieve a single contact › Responses
Contact found
idupdated_atLast modification time.
typefirst_nameFirst name of a person. null for companies or when the API user is not allowed to see it.
last_nameLast name of a person. ID#<id> when the contact is anonymised for the API user. null for companies.
company_nameCompany name. null for persons or when the API user is not allowed to see it.
tax_codeTax 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_numberVAT number (partita IVA) of a company. null for persons, when empty or when the API user is not allowed to see it.
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.
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^[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.
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^[a-z]{2}$Language to use to write to the contact. null if not set.
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.

