/api/v1/contactsscope contacts:readList contacts
The agency's contacts, newest first, each with its search profile. Filter with type. The fits_* filters keep only buyers and renters still searching whose search profile fits those facts, by the same rule as "Matchende kopers": a fact that breaks a set criterion drops the contact, a fact you leave out never does. Such a list is read completely and then paged.
Query parameters
limitintegerdefault 50Rows per page.
offsetintegerdefault 0Rows to skip.
typestringOnly contacts with this role.
seller · buyer · renter · landlord · syndic · notary · notary_buyer · notary_seller · other
fits_transactionstringSearch profile fits a property for sale or for rent.
sale · rent
fits_property_typestringSearch profile fits this kind of property.
apartment · studio · house · terraced_house · semi_detached · detached_villa · mansion · building_land · land · commercial · garage · other
fits_postal_codestringSearch profile fits this 4-digit postcode.
fits_pricenumberSearch profile fits this price in EUR (their maximum is not lower).
fits_bedroomsintegerSearch profile fits this many bedrooms (their minimum is not higher).
Example
curl "https://www.pando.immo/api/v1/contacts?fits_transaction=sale&fits_postal_code=2600&fits_price=400000&fits_bedrooms=3" \
-H "Authorization: Bearer pando_sk_..."Response 200 - data: list of 25 fields
iduuidPando id of the contact.
typestringRole of the contact.
seller · buyer · renter · landlord · syndic · notary · notary_buyer · notary_seller · other
first_namestring | nullFirst name.
last_namestring | nullLast name.
company_namestring | nullCompany name, for a company contact.
emailemail | nullE-mail address.
phonestring | nullPhone number.
mobilestring | nullMobile number.
streetstring | nullStreet and number.
postal_codestring | nullPostal code.
citystring | nullCity.
languagestringLanguage to address the contact in.
nl · fr · en
sourcestring | nullWhere the contact came from.
tagsstring[]Free tags.
gdpr_consent_atdate-time | nullWhen the contact agreed to be contacted about their own request. Never set through the API.
marketing_consent_atdate-time | nullWhen the contact agreed to receive marketing. Set through the API only with marketing_consent (POST /contacts, PATCH /contacts/{id}).
search_transactionstring | nullSearch profile: wants to buy (sale) or rent.
sale · rent
search_property_typesstring[]Search profile: kinds of property wanted (empty = any).
search_min_bedroomsinteger | nullSearch profile: at least this many bedrooms.
search_max_pricenumber | nullSearch profile: highest price in EUR (monthly rent for a renter).
search_min_surfaceinteger | nullSearch profile: at least this living area in m².
search_postal_codesstring[]Search profile: wanted postcodes (empty = anywhere).
created_atdate-timeWhen the record was created.
updated_atdate-timeWhen the record last changed.
pipeline_stagestringThe "Fase" of the contact in Pando. Sellers and landlords: new, qualifying, valuation, mandate, for_sale, under_offer, closing, won, lost. Buyers and renters: new, qualifying, searching, viewing, offer, under_offer, closing, won, lost.
new · qualifying · under_offer · closing · won · lost · valuation · mandate · for_sale · searching · viewing · offer