Changelog

Lookup API can now return the people a lead lives with

Andy Rossmeissl
Andy Rossmeissl
on

When a Lookup API request matches a person, it can now also return the other residents of that person's home in a cohabitants array, each with their own scores, personas and attributes. That way you can see who else is in the household behind a lead, for example a spouse, without asking the lead for more.

Each cohabitant comes with a temporary reference. To get that resident's full person-level response, including their name and home address, send the reference back to the same target as cohabitant_reference. A cohabitant lookup never returns a phone number or email address. References work only on the target that returned them and expire after 30 days.

Cohabitants are available on request. To turn them on for your account, contact your account team. See Cohabitants in the Lookup API docs.