Get Lead
Returns a single lead by ID. The response is wrapped under the ‘lead’ key.
Notes:
- By default, trashed leads are not returned. Pass withTrash=true to include them.
- Caller must have access to the lead; otherwise 404 LEAD_NOT_EXIST.
Headers
Bearer [access_token]
Path Parameters
ID of the lead to retrieve.
x >= 1Query Parameters
When true, include trashed leads in the lookup.
Response
Lead retrieved successfully.
false: can send message to the lead
false: can call to the lead
false: can email to the lead
The Id of the lead
The user Id of the lead
The first/given name of the lead
The last/family name of the lead
The birthday of the lead
The email list of the lead
The phone list of the lead
The leadSource(Id) about the lead
The source of the lead
The stageId of the lead
The stage of the lead
The user Id of the lead assigned to
The Username of the lead assigned to
The user Id of the lead's lender
The score of the lead
The tags of the lead
The teamId of the lead's team
The streetAddress associated with the lead. Deprecated: please use the streetAddress field in leadPropertyList instead.
The city associated with the lead. Deprecated: please use the city field in leadPropertyList instead.
The state associated with the lead. Deprecated: please use the state field in leadPropertyList instead.
The zip code associated with the lead. Deprecated: please use the zipCode field in leadPropertyList instead.
The create time of the lead
The assigned time of the lead
The Facebook account of the lead
The Twitter account of the lead
The lead is hidden or not
The referee of the lead
LeadInquirys
LeadPropertyList
User customized field
The update time of the lead
The groups that the lead in. Deprecated, use segments instead.
The segments that the lead in
Unsubscription the email
Types of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Renter (5), Investor (6), Agent (7), Homeowner (8), Landlord (9)
The last touch time of the lead
The last visit time of the lead
The status of the phone number Type id: invaild number(1), vaild number(2), talked(3), DNC Number(4), DNC Contact(5)
Whether complete all lead assign process
buying time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
"6-12"
Pre-qual, Yes or No
"Yes"
House to Sell, Yes or No
"Yes"
first time home buyer, Yes or No
"Yes"
With buyer Agent, Yes or No
"Yes"
selling time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
"1-3"
Mortgage, Yes or No.
"Yes"
Buy a house, Yes or No.
"Yes"
With listing agent, Yes or No.
"Yes"
The lead's current opportunity type, derived from on-platform lead scoring. One of: "High Interest", "Sell", "Back to Site", "Back on Market". Null when the lead has no active opportunity.
High Interest, Sell, Back to Site, Back on Market "High Interest"
A list of family members associated with the lead
The Id of the lead's pond
The Name of the lead's pond
The language of the lead
The entity ID associated with ownershipScope: the office ID when scope is OFFICE, or the agent's user ID when scope is PERSONAL. Not applicable when scope is TEAM.
The visibility scope of the lead. TEAM — Account-wide: visible to all users in this Lofty client account. OFFICE — visible only within a specific office. PERSONAL — visible only to a single agent. Note: TEAM refers to the entire client account (the organization), not the Lofty "Team add-on" product.