Search for people.
Available Response Fields
When making a GET request to
/v1/people, not all available fields are included in the response by default. Use thefieldsargument to request exactly the fields you need.You can use "allFields" in
fieldsduring development while you are unsure of what you need, but as this may return very large responses it is recommended to update this to specify exactly the fields you need for your production deployments to minimize the payload.
Including Relationships
You do not need to perform separate calls to
/v1/peopleRelationshipsto gather those associations. Include "relationships" in thefieldsquery parameter to include relationship information.
Determining Lead Type
If you are trying to determine the lead type, such as "Buyer" or "Seller", this can be done by looking at the returned tags. If the lead is a "Seller" type, there will be a "Seller" tag initially set when the lead is created, otherwise the lead is a "Buyer".
Other People Response Fields
| Key | Description |
|---|---|
| createdVia | This value indicates how this person was created. Possible values include "API", "Email Parsing", "Historic Email Parsing", "Import", and "Manually". |