1. Overview

Lofty service API description

1.1. Version information

Version : 1.0

1.2. URI scheme

Host : api.lofty.com
BasePath : /

1.3. Tags

  • Alerts : Operations about alerts

  • Calls : Operations about calls

  • Leads : Operations about leads

  • Members : Operations about team member

  • Notes : Operations about lead notes

  • Tasks : Operations about tasks

  • TeamFeatures: Operations about team features

  • Webhooks: Operations about webhooks

  • LogType : Operations about lead log call,log email,log text

  • Listing : Operations about listing

2. Getting Started

The simple REST API enables developers to quickly integrate their applications.
API services is actively developing to provide more complete functionality.

2.1. Authentication

   In order to ensure data security, Lofty has built-in support for OAuth 2.0 which is extremely useful when setting up integrations between third-party applications and Lofty without passwords being required. To obtain an OAuth2.0 access_token please refer to Lofty OAuth 2.0.

You should set access token, and content type to json through the API call service

Header Value

Content-type

application/json

Authorization

Bearer [access_token]

Note
   Rate limiting will be applied on June 15, 2021 for all those not using a vendorKey. If a vendorKey is not implemented before July 15, 2021, API access will not be available. Please complete the application (see link above) to apply for a security key BEFORE July 15, 2021 to ensure your connected services will not be affected.
   Once rate limiting starts (June 15, 2021), only ten calls per minute are allowed without a valid vendorKey. If the limit is exceeded, an error will be returned. The endpoints can be called again after one minute with the same limit of 10 calls per minute.

3. Pagination

List methods that return a collection of resources are paginated using offset and limit query parameters.

GET /v1.0/leads?offset=0&limit=10

Response contains "_metadata" section that includes total number of records available and pagination parameters used in the request:

{
  "_metadata": {
    "collection": "leads",
    "limit": 1,
    "offset": 0,
    "total": 1
  },
  "leads": [
    {
      "lead": {
        "firstName": "Kunkun",
        "lastName": "An",
        ...
      }
    }
    ...
  ]
}

4. Rate Limiting

The returned HTTP headers of any API request show your current rate limit status:

> curl -i -X GET --header 'Accept: application/json' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHQiOjMxNDc2NzM4OTM5NjYsInVzZXJfaWQiOjEwMDAwMDAwNTE0LCJzY29wZSI6IjUiLCJpYXQiOjE1NzA4NzM4OTM5NjZ9.wrnaQhzW7a7p34Y10uOvM36BDYmPcEqBq_Tt6j_1h' 'https://api.lofty.com/v1.0/me'
HTTP/1.1 200
Date: Sat, 21 Oct 2017 04:16:29 GMT
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 18
X-RateLimit-Reset: 23000
Header Name Description

X-RateLimit-Limit

The maximum number of requests you have allowed in the limited time.
(default: 500/minute)

X-RateLimit-Remaining

The number of requests remaining in the current rate limit window.

X-RateLimit-Reset

The time at which the current rate limit window resets in UTC epoch seconds.
(default: 60000 millisecond)

If you exceed the rate limit, an error response returns:

HTTP/1.1 429
Date: Sat, 21 Oct 2017 07:52:24 GMT
Status: 429 Too Many Requests
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 21000
{"message":"Too Many Requests"}

5. Resources

5.1. Agent User

Operations about agent user

5.1.1. Create a new agent with profile message

POST /v1.0/agent/profile/add
Parameters
Type Name Description Schema

Body

agentProfile
required

agentProfile

AgentProfile

Responses
HTTP Code Description Schema

200

OK

Result«long»

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

5.2. Calls

Operations about calls

5.2.1. Search for calls

GET /v1.0/calls
Parameters
Type Name Description Schema Default

Query

leadId
optional

Finds calls related to a lead ID

integer(int64)

"0"

Query

limit
optional

Number of results to return

integer(int32)

"10"

Query

offset
optional

Specifies the number of rows to skip, before starting to return results

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

CallListResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.2.2. Retrieve a call by Id

GET /v1.0/calls/{callId}
Parameters
Type Name Description Schema

Path

callId
required

The ID of the call

integer(int64)

Responses
HTTP Code Description Schema

200

OK

CallResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.3. Communication

Communication Controller

5.3.1. Search for communication by agent

POST /v1.0/agent/communication
Parameters
Type Name Description Schema

Body

communicationRequest
required

communicationRequest

CommunicationRequest

Responses
HTTP Code Description Schema

200

OK

PageResult

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.3.2. Search for call history

GET /v1.0/communication/call
Parameters
Type Name Description Schema Default

Query

currentId
optional

This parameter is used for page turning. When searching by ID is invoked, the interface would starts from this ID, and retrieve data sequentially. It is recommended to use this parameter as a replacement for offset to turn the page within the limit.

integer(int64)

"0"

Query

leadId
required

ID of Lead

integer(int64)

Query

limit
required

limit default Value 10, max value 1000

integer(int32)

"10"

Query

offset
required

offset default Value 0

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

< CallResponse > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.3.3. Search for call history v2

GET /v1.0/communication/call/v2
Parameters
Type Name Description Schema Default

Query

currentId
optional

This parameter is used for page turning. When searching by ID is invoked, the interface would starts from this ID, and retrieve data sequentially. It is recommended to use this parameter as a replacement for offset to turn the page within the limit.

integer(int64)

"0"

Query

leadId
required

ID of Lead

integer(int64)

Query

limit
required

limit default Value 10, max value 1000

integer(int32)

"10"

Query

offset
required

offset default Value 0

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

< CallHistory > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.3.4. Search for email history

GET /v1.0/communication/email
Parameters
Type Name Description Schema Default

Query

currentId
optional

This parameter is used for page turning. When searching by ID is invoked, the interface would starts from this ID, and retrieve data sequentially. It is recommended to use this parameter as a replacement for offset to turn the page within the limit.

integer(int64)

"0"

Query

leadId
required

ID of Lead

integer(int64)

Query

limit
required

limit default Value 10, max value 1000

integer(int32)

"10"

Query

offset
required

offset default Value 0

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

< EmailResponse > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.3.5. Search for text history

GET /v1.0/communication/text
Parameters
Type Name Description Schema Default

Query

currentId
optional

This parameter is used for page turning. When searching by ID is invoked, the interface would starts from this ID, and retrieve data sequentially. It is recommended to use this parameter as a replacement for offset to turn the page within the limit.

integer(int64)

"0"

Query

leadId
required

ID of Lead

integer(int64)

Query

limit
required

limit default Value 10, max value 1000

integer(int32)

"10"

Query

offset
required

offset default Value 0

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

< TextResponse > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.4. LeadRouting

Operations about lead routing

5.4.1. Get Assign Member List

GET /v1.0/routing/member/list/{type}
Parameters
Type Name Description Schema Default

Path

type
required

Routing type:AGENT_LEAD(1), LENDER_LEAD(2), ASSISTANT_LEAD(4)

integer(int32)

Query

roleId
optional

roleId

integer(int32)

"-1"

Responses
HTTP Code Description Schema

200

OK

AssignMember

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.4.2. Get Assign Role List

GET /v1.0/routing/role/list
Responses
HTTP Code Description Schema

200

OK

AssignRole

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.4.3. Get Routing List

GET /v1.0/routing/rule/list/{type}
Parameters
Type Name Description Schema Default

Path

type
required

Routing type:AGENT_LEAD(1), LENDER_LEAD(2), ASSISTANT_LEAD(4)

integer(int32)

Query

roleId
optional

Role id, This parameter is required when type == 4

integer(int32)

"-1"

Responses
HTTP Code Description Schema

200

OK

RoutingRule

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.4.4. Get default rule

GET /v1.0/routing/rule/supplement/{type}
Parameters
Type Name Description Schema Default

Path

type
required

Routing type:AGENT_LEAD(1), LENDER_LEAD(2), ASSISTANT_LEAD(4)

integer(int32)

Query

roleId
optional

Role id, This parameter is required when type == 4

integer(int32)

"-1"

Responses
HTTP Code Description Schema

200

OK

SupplementRoutingRule

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.4.5. Edit default routing rule

PUT /v1.0/routing/rule/supplement/{type}
Parameters
Type Name Description Schema

Path

type
required

Routing type:AGENT_LEAD(1), LENDER_LEAD(2), ASSISTANT_LEAD(4)

integer(int32)

Body

supplementRoutingRule
required

Supplement rule info that needs to be updatedstore

SupplementRoutingRuleRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.4.6. Edit routing rule

PUT /v1.0/routing/rule/{type}
Parameters
Type Name Description Schema

Path

type
required

Routing type:AGENT_LEAD(1), LENDER_LEAD(2), ASSISTANT_LEAD(4)

integer(int32)

Body

routingRule
required

Lead info that needs to be updated

RoutingRuleRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5. Leads

Operations about leads

5.5.1. Edit a lead from brokermint

PUT /v1.0/brokermint/lead
Parameters
Type Name Description Schema

Body

contacts
required

Lead info that needs to be updated

Contacts

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.2. Update a transaction from brokermint

PUT /v1.0/brokermint/transaction
Description

Update a transaction from brokermint for a lead.

Parameters
Type Name Description Schema

Body

incomingTransaction
required

Lead transaction that needs to be placed

IncomingTransaction

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.3. Create a new lead

POST /v1.0/leads
Description

Lead routing will not be applied unless the leadRouting flag is set to true
Seller(1) Type Lead routing is controlled by LeadRequest.property schema
If the given leadType is not Seller, the lead routing is determined by array LeadRequest.inquiry.locations[]

Parameters
Type Name Description Schema

Body

hideVendorId
optional

hideVendorId

integer(int64)

Body

lead
required

Lead info that needs to be added in

LeadRequest

Responses
HTTP Code Description Schema

200

OK
Example: {leadId: 651095960136641}

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.4. Search for leads

GET /v1.0/leads
Parameters
Type Name Description Schema Default

Query

allTags
optional

Search for lead with all tag names.

< string > array(multi)

Query

anyTags
optional

Search for lead with any tag names.

< string > array(multi)

Query

assignedUserId
optional

Search for contacts by user that is assigned to them.

integer(int64)

"-1"

Query

contacted
optional

Search for contacts by if they have or have not been contacted.

boolean

"true"

Query

desc
optional

Descending sort(true) or ascending sort(false)

boolean

"true"

Query

email
optional

Precise search for lead by email address.

string

Query

groupIds
optional

Search for lead by office ids.

< integer(int64) > array(multi)

Query

groups
optional

Search for lead by group names. deprecated, use segments instead.

< string > array(multi)

Query

languages
optional

Search for lead with any languages(abbreviation)

< string > array(multi)

Query

limit
optional

Quantitative limitation of responded leads, range: [1, 100]

integer(int32)

"25"

Query

offset
optional

Start index of the responded leads

integer(int32)

"-1"

Query

phone
optional

Precise search for lead by phone number.
Example: 3479033333

string

Query

preciseSearchFlag
optional

Whether to precise search for leads based on email or phone

boolean

"false"

Query

querySubGroup
optional

query sub group leads or not

boolean

"true"

Query

roleAssigneeFilters
optional

[{"roleName":"Lead assign role name","assigneeToIds":[111,222]}]

string

Query

scrollId
optional

Scroll ID for the search. You can then use the scroll ID to retrieve the next batch of results for the request.

string

Query

segments
optional

Search for lead by segment names.

< string > array(multi)

Query

sort
optional

The sort order can be one of the following: Default, LastContact, LastCall, LastEmail, LastActivity, CreateTime, Inquries, DeleteTime, AssignTime, Score, Activity, Communication, HasDrip, HasAlert, Task, Lender, ActivitySearch, ActivityViews, ActivityFavorites, DripStatus, DripOpenRate, AlertFrequency, AlertOpenRate, SCOREV2 or SmartPlanStatus

string

Query

source
optional

Search for lead by source name.

string

Query

stage
optional

Search for lead by pipeline stage names.

< string > array(multi)

Responses
HTTP Code Description Schema

200

OK

LeadListResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.5.5. Search for assignee by lead info

POST /v1.0/leads/assignee
Parameters
Type Name Description Schema

Body

leadAssigneeRequest
required

Lead info that needs to be searched

LeadAssigneeRequest

Responses
HTTP Code Description Schema

200

OK

< LeadCustomRoleAssigneeInfo > array

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.6. Retrieve the specified URL with a login token

POST /v1.0/leads/specified-url
Parameters
Type Name Description Schema

Body

linkRequest
required

linkRequest

LinkRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.7. Retrieve a lead by Id

GET /v1.0/leads/{leadId}
Parameters
Type Name Description Schema Default

Path

leadId
required

The ID of the lead to get.

integer(int64)

Query

withTrash
optional

Whether to query deleted lead.

boolean

"false"

Responses
HTTP Code Description Schema

200

OK

LeadResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.5.8. Edit a lead

PUT /v1.0/leads/{leadId}
Parameters
Type Name Description Schema

Path

leadId
required

The ID of the lead to update.

integer(int64)

Body

request
required

Lead info that needs to be updated

EditLeadRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.9. Delete a lead

DELETE /v1.0/leads/{leadId}
Parameters
Type Name Description Schema

Path

leadId
required

The ID of the lead to trash.

integer(int64)

Query

reason
required

The reason to trash this lead

string

Responses
HTTP Code Description Schema

200

OK

string

204

No Content

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

Produces
  • application/json

5.5.10. Search for activities

GET /v1.0/leads/{leadId}/activities
Parameters
Type Name Description Schema Default

Path

leadId
required

leadId

integer(int64)

Query

curPage
optional

The page number of the returning data. One page has 100 data. Default value is 0.

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

< LeadActivityRes > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.5.11. Add activity

POST /v1.0/leads/{leadId}/activity
Description

Add activity to a lead.

Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Body

leadActivity
required

Lead activity

LeadActivityReq

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.12. Assign a lead

POST /v1.0/leads/{leadId}/assignment
Description

Place assignee to a lead.

Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Body

assigneeRequest
required

Lead assignees

< LeadAssigineeRequest > array

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.13. Place an inquiry

POST /v1.0/leads/{leadId}/inquiry
Description

Place an inquiry for a lead.

Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Body

inquiry
required

Lead inquiry that needs to be placed

LeadInquiryReq

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.14. Place a property

POST /v1.0/leads/{leadId}/property
Description

Place a property for a lead.

Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Body

property
required

Lead property that needs to be placed

LeadPropertyReq

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.15. Add a transaction

POST /v1.0/leads/{leadId}/transaction
Description

Add a transaction for a lead.

Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Body

leadTransaction
required

Lead transaction that needs to be placed

LeadTransaction

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.16. Update address of transaction’s property

POST /v1.0/leads/{leadId}/transaction/property/address
Description

Update address of transaction’s property for a lead.

Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Body

address
required

Address of lead transaction’s property that needs to be placed

LeadTransactionPropertyAddress

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.17. query transaction by leadId AND transactionId

GET /v1.0/leads/{leadId}/transaction/{transactionId}
Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Path

transactionId
required

transactionId

integer(int64)

Responses
HTTP Code Description Schema

200

OK

LeadTransaction

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.5.18. Update a transaction

PUT /v1.0/leads/{leadId}/transaction/{transactionId}
Description

Update a transaction for a lead.

Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Path

transactionId
required

transactionId

integer(int64)

Body

leadTransaction
required

Lead transaction that needs to be placed

LeadTransaction

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.5.19. Query address of transaction’s property by transactionId

GET /v1.0/leads/{leadId}/transaction/{transactionId}/property/address
Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Path

transactionId
required

transactionId

integer(int64)

Responses
HTTP Code Description Schema

200

OK

LeadTransactionPropertyAddress

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.5.20. query transactions by leadId

GET /v1.0/leads/{leadId}/transactions
Parameters
Type Name Description Schema

Path

leadId
required

leadId

integer(int64)

Responses
HTTP Code Description Schema

200

OK

< LeadTransaction > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.5.21. query transaction all custom fields

GET /v1.0/transaction/customfields
Responses
HTTP Code Description Schema

200

OK

< CustomFieldResponse > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.6. Members

Operations about team member

5.6.1. Get current user’s info

GET /v1.0/me
Responses
HTTP Code Description Schema

200

OK

UserResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.6.2. Get team members

GET /v1.0/members
Parameters
Type Name Description Schema Default

Query

groupIds
optional

Group Ids of responded members

< integer(int64) > array(multi)

Query

limit
optional

Quantitative limitation of responded members

integer(int32)

"25"

Query

offset
optional

Start index of the responded members

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

MemberListResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.6.3. Get member by account

GET /v1.0/members/{account}
Description

Get team member by member account.

Parameters
Type Name Description Schema

Path

account
required

The account (email) of the team member to get

string

Responses
HTTP Code Description Schema

200

OK

string

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

5.6.4. Get user by Id

GET /v1.0/users/{userId}
Caution

operation.deprecated

Parameters
Type Name Description Schema

Path

userId
required

The ID of the user to get

integer(int64)

Responses
HTTP Code Description Schema

200

OK

UserResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.6.5. Edit a user

PUT /v1.0/users/{userId}
Parameters
Type Name Description Schema

Path

userId
required

userId

integer(int64)

Body

userRequest
required

user info that needs to be updated

UserRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.7. Notes

Operations about lead notes

5.7.1. Add a note

POST /v1.0/notes
Parameters
Type Name Description Schema

Body

leadNote
required

LeadNote info that needs to be added in

NoteRequest

Responses
HTTP Code Description Schema

200

OK
Example: {noteId: 12345}

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.7.2. Search for notes

GET /v1.0/notes
Parameters
Type Name Description Schema Default

Query

includeSystemNote
optional

Include System note or not

boolean

"false"

Query

leadId
required

ID of Lead

integer(int64)

Responses
HTTP Code Description Schema

200

OK

< NoteResponse > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.7.3. Get note by Id

GET /v1.0/notes/{noteId}
Parameters
Type Name Description Schema

Path

noteId
required

ID of Note

integer(int64)

Responses
HTTP Code Description Schema

200

OK

NoteResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.7.4. Edit a note

PUT /v1.0/notes/{noteId}
Parameters
Type Name Description Schema

Path

noteId
required

The ID of the note to update

integer(int64)

Body

leadNote
required

LeadNote info that needs to be updatedstore

NoteRequest

Responses
HTTP Code Description Schema

200

OK

No Content

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json;charset=UTF-8

5.7.5. Delete a note

DELETE /v1.0/notes/{noteId}
Parameters
Type Name Description Schema

Path

noteId
required

The ID of the note to delete

integer(int64)

Responses
HTTP Code Description Schema

200

OK

No Content

204

No Content

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

Produces
  • application/json;charset=UTF-8

5.8. Tasks & Appointments

Operations about tasks and appointments

5.8.1. Get appointments of lead

GET /v1.0/appts
Parameters
Type Name Description Schema

Query

leadId
required

Lead id

integer(int64)

Responses
HTTP Code Description Schema

200

OK

Appointment

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.8.2. Add a new task

POST /v1.0/tasks
Parameters
Type Name Description Schema

Body

leadTask
required

LeadTask info that needs to be added in

TaskRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.8.3. Get tasks of lead

GET /v1.0/tasks
Parameters
Type Name Description Schema

Query

leadId
required

The ID of the lead to get tasks

integer(int64)

Responses
HTTP Code Description Schema

200

OK

TaskResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.8.4. Get task by Id

GET /v1.0/tasks/{taskId}
Parameters
Type Name Description Schema

Path

taskId
required

The ID of the task to get

integer(int64)

Responses
HTTP Code Description Schema

200

OK

TaskResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.8.5. Update a new task

PUT /v1.0/tasks/{taskId}
Description

If the finish flag is true, there is no need to update the rest of the task

Parameters
Type Name Description Schema

Path

taskId
required

The ID of the Task to update

integer(int64)

Body

leadTask
required

LeadTask info that needs to be updated

TaskRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.8.6. Delete a task

DELETE /v1.0/tasks/{taskId}
Parameters
Type Name Description Schema

Path

taskId
required

The ID of the Task to delete

integer(int64)

Responses
HTTP Code Description Schema

200

OK

string

204

No Content

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

Produces
  • application/json

5.9. TeamFeatures

Operations about team feature

5.9.1. Search lead pond

GET /v1.0/team-features/lead-pond/{id}
Parameters
Type Name Description Schema

Path

id
required

id

integer(int64)

Responses
HTTP Code Description Schema

200

OK

LeadPond

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.9.2. list lead pond

GET /v1.0/team-features/lead-ponds
Responses
HTTP Code Description Schema

200

OK

< LeadPond > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.9.3. add new custom field

POST /v1.0/teamFeatures/custom-field
Parameters
Type Name Description Schema

Body

customAttribute
required

customAttribute

CustomAttribute

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.9.4. Search custom field

GET /v1.0/teamFeatures/listCustomField
Responses
HTTP Code Description Schema

200

OK

< CustomAttribute > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.9.5. Search existing tag

GET /v1.0/teamFeatures/listTag
Responses
HTTP Code Description Schema

200

OK

< UserLeadTag > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.10. User Account

Operations about user account

5.10.1. Create an new account

POST /v1.0/agent
Parameters
Type Name Description Schema

Body

accountRequest
required

account info that needs to be created

AccountRequest

Responses
HTTP Code Description Schema

200

OK

AccountResponse

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.10.2. Edit an account

PUT /v1.0/agent
Parameters
Type Name Description Schema

Body

accountRequest
required

account info that needs to be edited

AccountRequest

Responses
HTTP Code Description Schema

200

OK

AccountResponse

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.11. Vendor

Vendor Controller

5.11.1. query vendor info

GET /v1.0/vendor/list
Responses
HTTP Code Description Schema

200

OK

< VendorInfo > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.11.2. get oauth token info by old apikey

GET /v1.0/vendor/oauth/token-info/byold
Responses
HTTP Code Description Schema

200

OK

OauthTokenInfo

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.12. Webhooks

Use webhooks to be notified about events that happen in a lofty account
supported webhook events:
1, Agent List
List id: 1
Scope: UserResponse
2, Lead Information
List id: 2
Scope: LeadResponse
3, Lead Activity
List id: 3
Scope: LeadActivity 4, Listing Alert
List id: 4
Scope: Alert

5.12.1. add a new webhook

POST /v1.0/webhook
Parameters
Type Name Description Schema

Body

webhookRequest
required

webhook info that needs to be added in

WebhookRequest

Responses
HTTP Code Description Schema

200

OK

WebhookResponse

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.12.2. Delete a webhook

DELETE /v1.0/webhook/{subscribeId}
Parameters
Type Name Description Schema

Path

subscribeId
required

The subscribeId of the webhook to delete

integer(int64)

Responses
HTTP Code Description Schema

200

OK

string

204

No Content

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

Produces
  • application/json

5.12.3. get all webhook from current team

GET /v1.0/webhooks
Responses
HTTP Code Description Schema

200

OK

string

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.13. Agent Organization

Operations agent organization

5.13.1. Get User Organization

GET /v1.0/org
Responses
HTTP Code Description Schema

200

OK

OrganizationInfo

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.13.2. Edit Agent Company

POST /v1.0/org/company
Parameters
Type Name Description Schema

Body

vo
required

vo

CompanyOpenVo

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.13.3. Update Agent Office

POST /v1.0/org/office
Parameters
Type Name Description Schema

Body

vo
required

vo

OfficeOpenVo

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.13.4. Add Agent Office

PUT /v1.0/org/office
Parameters
Type Name Description Schema

Body

vo
required

vo

OfficeOpenVo

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.13.5. Get Permission Profiles

GET /v1.0/org/permission/profiles
Responses
HTTP Code Description Schema

200

OK

< PermissionProfile > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.14. Broker

Operations about broker team

5.14.1. Create team under the broker account

POST /v1.0/broker/team
Parameters
Type Name Description Schema

Body

brokerTeam
required

brokerTeam

BrokerTeam

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.14.2. Remove team from the broker account

DELETE /v1.0/broker/team/{id}
Parameters
Type Name Description Schema

Path

id
required

id

integer(int64)

Responses
HTTP Code Description Schema

200

OK

string

204

No Content

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

Produces
  • application/json

5.15. Listing

Listing data Controller

5.15.1. Get published listings

GET /v1.0/getPublishedListings
Parameters
Type Name Description Schema

Query

type
required

LuxVT|AptCom|AllOnMarket

string

Responses
HTTP Code Description Schema

200

OK

string

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/xml

5.15.2. getByUserId

GET /v1.0/listing
Parameters
Type Name Description Schema Default

Query

agentListings
optional

agentListings

boolean

"false"

Query

buildingAddress
optional

buildingAddress

string

Query

buildingName
optional

buildingName

string

Query

limit
optional

limit

integer(int32)

"25"

Query

listingId
optional

listingId

string

Query

mlsListingIds
optional

mlsListingIds

string

Query

nextPageKey
optional

nextPageKey

string

Query

officeListings
optional

officeListings

boolean

"false"

Query

showCondition
optional

showCondition

boolean

"false"

Query

soldListingId
optional

soldListingId

string

Query

street
optional

street

string

Query

userId
optional

userId

integer(int64)

"0"

Responses
HTTP Code Description Schema

200

OK

string

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.16. LogType

Operations about lead log call/log email/log text

5.16.1. Add a log call/email/text

POST /v1.0/logType
Parameters
Type Name Description Schema

Body

request
required

logType info that needs to be added in

LogTypeRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.16.2. Search for log call/email/text

GET /v1.0/logType
Parameters
Type Name Description Schema Default

Query

currentId
optional

This parameter is used for page turning. When searching by ID is invoked, the interface would starts from this ID, and retrieve data sequentially. It is recommended to use this parameter as a replacement for offset to turn the page within the limit.

integer(int64)

"0"

Query

leadId
required

ID of Lead

integer(int64)

Query

limit
required

limit default Value 10, max value 1000

integer(int32)

"10"

Query

logType
required

query type value: logCall,logEmail,logText

string

Query

offset
required

offset default Value 0

integer(int32)

"0"

Responses
HTTP Code Description Schema

200

OK

< LogTypeResponse > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.16.3. Get log call/email/text by Id

GET /v1.0/logType/{logTypeId}
Parameters
Type Name Description Schema

Path

logTypeId
required

ID of Log type

integer(int64)

Responses
HTTP Code Description Schema

200

OK

LogTypeResponse

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

5.16.4. Delete a log type

DELETE /v1.0/logType/{logTypeId}
Parameters
Type Name Description Schema

Path

logTypeId
required

The ID of the log type to delete

integer(int64)

Responses
HTTP Code Description Schema

200

OK

No Content

204

No Content

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

Produces
  • application/json;charset=UTF-8

5.17. Opportunity

Operations about opportunity

5.17.1. sendOpportunityNotification

POST /v1.0/agent/send-notification
Parameters
Type Name Description Schema

Body

opportunityNotificationRequest
required

opportunityNotificationRequest

OpportunityNotificationRequest

Responses
HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Consumes
  • application/json

Produces
  • application/json

5.18. System Logs

query lead system logs

5.18.1. Search for system logs

GET /v1.0/systemLogs
Parameters
Type Name Description Schema Default

Query

endTime
optional

the timestamp of end

integer(int64)

"-1"

Query

leadId
required

ID of Lead

integer(int64)

Query

pageNumber
optional

page number, fist is 0

integer(int32)

"0"

Query

pageSize
optional

ID of Lead

integer(int32)

"100"

Query

startTime
optional

the timestamp of start

integer(int64)

"-1"

Responses
HTTP Code Description Schema

200

OK

< SystemLogResponse > array

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Produces
  • application/json

6. Definitions

6.1. AccountInfo

Name Description Schema

allowChangeDomain
optional

boolean

domain
optional

string

emailAddress
required

email address of the agent
Example : "aaaa@google.com"

string

firstName
required

first name of the agent
Example : "Bob"

string

groupId
optional

integer(int64)

headUrl
optional

The head url of the agent
Example : "http://xxx"

string

lastName
required

last name of the agent
Example : "Bob"

string

phoneCode
optional

phone code of the agent
Example : "000001"

string

phoneCountry
optional

phone country of the agent
Example : "000001"

string

phoneNumber
optional

phone number of the agent
Example : "83834748"

string

roleId
optional

integer(int64)

roleName
required

role of the agent
Example : "Company Admin, Standard User"

string

sendingEmail
optional

string

tagIds
optional

tags of the agent

< integer(int64) > array

6.2. AccountRequest

Name Description Schema

address
optional

address of the agent
Example : "NewYork"

string

allowChangeSendingEmailAddress
optional

Allow this individual to change their own sending email domain
Example : false

boolean

emailAddress
required

The email of the agent
Example : "roseTest@lofty.com"

string

firstName
required

The first name of the agent
Example : "Rose"

string

groupId
required

Group Id.

integer(int64)

lastName
required

The last name of the agent
Example : "Bob"

string

licenseId
optional

licenseId of the agent
Example : "LicenseId"

string

personalWebsite
optional

Personal Website
Example : "Personal Website"

string

phone
optional

The phone number of the agent
Example : "19022342233"

string

position
optional

position
Example : "position"

string

profileId
required

Permission Profile Id.

integer(int64)

selfIntroduction
optional

Self Introduction
Example : "Self Introduction"

string

sendingEmailAddress
optional

Sending Email Address Domain
Example : "false"

string

socialMedias
optional

Social media of agent, include company info

SocialMedias

teamMemberUserId
optional

the id of the agent
Example : 5865865860

integer(int64)

6.3. AccountResponse

Name Description Schema

agentId
optional

The id of the agent

integer(int64)

allowChangeSendingEmailAddress
optional

Allow this individual to change their own sending email domain

boolean

emailAddress
optional

The email of the agent

string

firstName
optional

The first name of the agent

string

groupId
optional

Group Id

integer(int64)

lastName
optional

The last name of the agent

string

phone
optional

The phone number of the agent

string

profileId
optional

Permission Profile Id

integer(int64)

seatType
optional

integer(int32)

sendingEmailAddress
optional

Sending Email Address Domain

string

teamId
optional

The teamId of the agent’s team

integer(int64)

6.4. ActiveHours

Name Description Schema

activeDays
optional

Active day list, between 1 and 7

< integer(int32) > array

hoursEnd
optional

Active hours end, between 0 and 23

integer(int32)

hoursStart
optional

Active hours start, between 0 and 23

integer(int32)

6.5. AgentInfo

Name Description Schema

agentPid
optional

Agent Pid

string

companyAddress
optional

Agent company Address

string

companyName
optional

Agent Company Name

string

licenseId
optional

Agent license Id

string

mlsAgentId
optional

MLS Agent Id

string

position
optional

Agent position

string

6.6. AgentProfile

Name Description Schema

accountInfo
required

Account Base Info of agent, like name , email or phone and something else

AccountInfo

accountType
required

The account type of the agent
Example : "display only for number 2 or user for number 1"

integer(int32)

agentPid
optional

string

checkRosterNum
optional

boolean

fullSync
optional

boolean

hasBackOffice
optional

boolean

personalPhotos
optional

Personal photos of agent

PersonalPhotos

shouldSync
optional

boolean

socialMedias
optional

Social media of agent, include company info

SocialMedias

workInfo
optional

Work Info of agent, include company info etc..

WorkInfo

6.7. Appointment

Name Description Schema

address
optional

The location of the appointment

string

allDay
optional

Whether the appointment time is all day

boolean

assignRoleType
optional

The user role of the appointment assigned to

integer(int32)

assignToUid
optional

The user’s Id of the appointment assigned to

integer(int64)

createTime
optional

The create time of the appointment

string(date-time)

creatorId
optional

The user ID of this appointment creator

integer(int64)

deadline
optional

The start time of the appointment

integer(int64)

deleteFlag
optional

If the appointment is deleted or not

boolean

descr
optional

The description of the appointment

string

endTime
optional

The end time of the appointment

integer(int64)

finishFlag
optional

If the appointment is finished or not

boolean

finishTime
optional

The finish time of the task

integer(int64)

id
optional

The Id of the appointment

integer(int64)

lastUpdate
optional

The last update time of the appointment

string(date-time)

leadId
optional

The lead(Id) associated with the appointment

integer(int64)

overdue
optional

If the appointment is overdue or not

boolean

6.8. AssignMember

Name Description Schema

id
optional

Member id

integer(int64)

name
optional

Member name

string

type
optional

Member type
Example : "Agent(1), Lender(2), Pond(3);"

integer(int32)

6.9. AssignRole

Name Description Schema

id
optional

Role id

integer(int64)

name
optional

Role name

string

6.10. BrokerTeam

Name Description Schema

email
required

Team admin email

string

firstName
required

Team admin first name

string

lastName
required

Team admin last name

string

phone
required

Team admin phone

string

seatLimit
required

Team seat limit

integer(int32)

teamName
required

Team Name

string

6.11. CallHistory

Name Description Schema

agentId
optional

The Id of the agent

integer(int64)

createTime
optional

The createTime of the call

string

direction
optional

Outbound or Inbound call
Example : "outbound"

string

id
optional

The Id of the call

integer(int64)

leadId
optional

The lead(Id) associated with the call

integer(int64)

leadPhoneNumber
optional

The phone number of the lead

string

6.12. CallListResponse

Name Schema

_metadata
optional

MetaData

calls
optional

< CallResponse > array

6.13. CallResponse

Name Description Schema

agentId
optional

The related Agent ID

integer(int64)

callingOutcome
optional

The outcome of the call
Example : "Talked"

string

createTime
optional

The createTime of the call

string

dialerCallRecordId
optional

The Id of the call record

integer(int64)

direction
optional

Outbound or Inbound call
Example : "Outbound"

string

duration
optional

The duration of the call

integer(int32)

elapsedTime
optional

The connection time of the call

string

endTime
optional

The end time of the call

string

id
optional

The Id of the call

integer(int64)

isMachineAnswered
optional

If the call is answered by machine

boolean

leadId
optional

The lead(Id) associated with the call

integer(int64)

leadPhoneNumber
optional

The phone number of the lead

string

note
optional

The note of the call

string

price
optional

The price of the call

number(double)

rateScore
optional

The rateScore of the call

integer(int32)

recordingSwitch
optional

If record this call or not

boolean

showUserNumber
optional

The phone number showed for the lead who received this call

string

startTime
optional

The start time of the call

string

status
optional

The status of the call

string

updateTime
optional

The updateTime of the call

string

userId
optional

The Id of the user

integer(int64)

userPhoneNumber
optional

The phone number of the user

string

6.14. Commission

Name Description Schema

calculateType
optional

AMOUNT. default AMOUNT

enum (AMOUNT, PERCENT)

desc
optional

no more than 512 chars

string

id
optional

integer(int64)

payTo
required

agentId, teamId or leadId

integer(int64)

payToName
optional

no more than 255 chars

string

payType
required

TEAM, AGENT, VENDOR_PARTNER, LEAD, OTHER. default AGENT

enum (AGENT, BROKERAGE, LEAD, OTHER, TEAM, VENDOR_PARTNER)

splitPayTo
required

agentId, teamId or leadId

integer(int64)

splitPayToName
optional

no more than 255 chars

string

splitPayType
required

enum: TEAM, AGENT, VENDOR_PARTNER, LEAD, OTHER, BROKERAGE. default AGENT

enum (AGENT, BROKERAGE, LEAD, OTHER, TEAM, VENDOR_PARTNER)

value
required

pay amount in cents or percentage(for example,5023, 8010) value differentiated by calculateType. If less than 0 then Deduct else Add as for Pre-Split and Post-Split

integer(int64)

6.15. Commissions

Name Description Schema

postSplit
optional

Post Split Commissions

< Commission > array

preSplit
optional

Pre Split Commissions

< Commission > array

split
optional

Split Commissions

< Commission > array

6.16. CommunicationRequest

Name Description Schema

endTime
required

endTimestamp (The maximum time interval for a single query is 24 hours)
Example : 946710000000

integer(int64)

limit
optional

limit default Value 10,max value 1000
Example : 50

integer(int32)

offset
optional

offset default Value 0
Example : 0

integer(int32)

startTime
required

startTimestamp
Example : 946710000000

integer(int64)

teamView
optional

search team lead’s communication, default false
Example : false

boolean

type
required

CALL, EMAIL OR TEXT
Example : "CALL"

enum (CALL, EMAIL, TEXT)

6.17. CommunicationResponse

Name Description Schema

agentId
optional

The related Agent ID

integer(int64)

callDuration
optional

Dialer call duration

string

callOutcome
optional

Dialer call outcome
Example : "Talked"

string

communicationTime
optional

The time of the communication

string

communicationType
optional

The communication type (AUTO, MANUAL OR LOGGED)
Example : "AUTO"

string

direction
optional

Outbound or Inbound
Example : "Outbound"

string

eventType
optional

The event type (Call, Text, Opened Email, Bounced Email or Sent Email)
Example : "Call"

string

fromPond
optional

Is the communication from the lead pond

boolean

id
optional

The ID of the communication

integer(int64)

leadId
optional

The lead(Id) associated with the communication

integer(int64)

status
optional

The communication status
Example : "Delivered"

string

6.18. CompanyOpenVo

Name Schema

city
optional

string

email
optional

string

header
optional

string

name
optional

string

phone
optional

string

phoneCode
optional

string

phoneCountry
optional

string

state
optional

string

streetAddress
optional

string

teamId
optional

integer(int64)

zipcode
optional

string

6.19. Contacts

Name Schema

address
optional

string

bmPrivate
optional

boolean

city
optional

string

contactType
optional

string

email
optional

string

externalId
optional

string

firstName
optional

string

lastName
optional

string

leadSource
optional

string

phone
optional

string

state
optional

string

zip
optional

string

6.20. CustomAttribute

Name Description Schema

attributeName
required

The name of this custom field

string

attributeType
required

The type of the field
Example : "number, text, date, single_select, multi_select, percentage, currency"

string

params
optional

options for select, such as {"option":["item1","item2",…]}

string

value
required

The content of the field for lead, value for multi-select,such as "["item1","item2\s",…]" .It’s unnecessary when adding a new custom field for team

string

6.21. CustomFieldRequest

Name Description Schema

id
optional

Custom field id

integer(int64)

value
optional

Custom field value For multi_select, the format is:["Item1","Item2", …]

string

6.22. CustomFieldResponse

Name Description Schema

id
optional

Custom field id

integer(int64)

name
optional

Custom field name

string

params
optional

Custom field drop-down params

string

type
optional

Custom field type

string

6.23. CustomRole

Name Description Schema

assignee
optional

The user account of this custom role

string

assigneeId
optional

The user id of this custom role

integer(int64)

role
required

The name of this custom role

string

roleId
required

The ID of this custom role

integer(int32)

6.24. CustomRoleAssignee

Name Description Schema

agentFullName
optional

Agent Full Name

string

assignee
optional

The user account of this custom role

string

assigneeId
optional

The user id of this custom role

integer(int64)

permissionProfileName
optional

The permission profile name of this custom role

string

role
optional

The name of this custom role

string

roleId
optional

The ID of this custom role

integer(int32)

6.25. EditLeadRequest

Name Description Schema

assignedUserId
optional

Id of the agent assigned to this contact
Example : 10000000514

integer(int64)

birthday
optional

The birthday of the lead(pattern:MMM d, yyyy)
Example : "Jun 5, 2001"

string

buyHouse
optional

Buy a house, Yes or No.
Example : "Yes"

string

buyingTimeFrame
optional

buying time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example : "6-12"

string

cannotCall
optional

false: can call to the lead

boolean

cannotEmail
optional

false: can email to the lead

boolean

cannotText
optional

false: can send message to the lead

boolean

city
optional

The city associated with the lead
Example : "Washington DC"

string

customAttributeList
optional

User customized field

< CustomAttribute > array

emails
optional

A list of email addresses associated with the lead

< string > array

firstName
optional

The first/given name of the lead
Caution: Max limit 30 characters. If you exceed the limit, the import will succuss, but only import 30 characters in front.
Example : "Bob"

string

fthb
optional

first time home buyer, Yes or No.
Example : "Yes"

string

groups
optional

The groups the lead is in
Caution: Max limit 30 characters.If you exceed the limit,the import will success , but only import 30 characters in front. deprecated, use segments instead.

< string > array

houseToSell
optional

House to Sell, Yes or No.
Example : "Yes"

string

inquiry
optional

The inquiry of the lead

LeadInquiryReq

isHidden
optional

The lead is hidden or not
Example : false

boolean

language
optional

The lead’s abbreviated language, en, fr, de, es, zh-CN, zh-TW, ja
Example : "en"

string

lastName
optional

The last/family name of the lead
Caution: Max limit 30 characters. If you exceed the limit, the import will succuss, but only import 30 characters in front.
Example : "Li"

string

leadFamilyMemberList
optional

A list of family members associated with the lead. You can add up to 4 family members.

< LeadFamilyMember > array

leadTransaction
optional

LeadTransaction

leadType
optional

Type of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Buyer & Seller (3), Renter (5)
Example : -1

integer(int32)

leadTypes
optional

Types of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Renter (5), Investor (6), Agent (7),Homeowner (8), Landlord (9)

< integer(int32) > array

mortgage
optional

Mortgage, Yes or No.
Example : "Yes"

string

ownershipId
optional

Specific owner id of lead, such as office id and agent id.

integer(int64)

ownershipScope
optional

Ownership level of lead. (If it is office or personal, you need to pass a value to ownershipID to specify the entity.)
Example : "TEAM, OFFICE, PERSONAL"

string

phones
optional

A list of phone numbers associated with the lead. (No more than 20 characters per phone)

< string > array

preQual
optional

Pre-qual, Yes or No.
Example : "Yes"

string

property
optional

The property of the lead.

LeadPropertyReq

referredBy
optional

The referee of the lead
Example : "Jeremy Kelly"

string

segments
optional

The segments the lead is in
Caution: Max limit 30 characters.If you exceed the limit,the import will success , but only import 30 characters in front.

< string > array

sellingTimeFrame
optional

selling time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example : "1-3"

string

source
optional

The source of the lead
Example : "Open House"

string

stage
optional

The stage the lead is in, less than 20 characters
Example : "Pending"

string

state
optional

The state associated with the lead
Example : "Washington DC"

string

streetAddress
optional

The streetAddress associated with the lead
Example : "The White House,1600 Pennsylvania Avenue NW"

string

tags
optional

The tags associated with the lead. All existing tags will be updated based on this call
Caution: Max limit 64 characters.If you exceed the limit,the import will success , but only import 64 characters in front.

< string > array

tagsAdd
optional

The tags associated with the lead. All existing tags will be retained, only add new tags base on this call
Caution: Max limit 64 characters. If you exceed the limit, the import will success, but only import 64 characters in front.

< string > array

unsubscription
optional

Unsubscription the email

boolean

withBuyerAgent
optional

With buyer Agent, Yes or No.
Example : "Yes"

string

withListingAgent
optional

With listing agent, Yes or No.
Example : "Yes"

string

zipCode
optional

ZipCode
Example : "20500"

string

6.26. EmailResponse

Name Description Schema

agentId
optional

The related Agent ID

integer(int64)

direction
optional

Outbound or Inbound email
Example : "Outbound"

string

emailEventTime
optional

The event time of the email

string

emailSubject
optional

The subject of the email

string

emailType
optional

Manual or Auto email
Example : "Auto"

string

eventType
optional

Sent, Opened or Bounced event
Example : "Sent"

string

fromPond
optional

Is the email sent from the lead pond

boolean

id
optional

The ID of the email

integer(int64)

leadId
optional

The lead(Id) associated with the email

integer(int64)

6.27. EnterpriseInfo

Name Description Schema

groupId
optional

Group ID

integer(int64)

groupName
optional

Group Name

string

profileId
optional

Permission Profile ID

integer(int64)

profileName
optional

Permission Profile Name

string

visibleOrgInfoList
optional

Visible Sub Org Info

< VisibleOrgInfo > array

6.28. FileInfo

Name Schema

contentType
optional

string

fileName
optional

string

queryLink
optional

string

size
optional

integer(int32)

6.29. IncomingTransaction

Name Schema

acceptanceDate
optional

Timestamp

address
optional

string

agentId
optional

integer(int64)

agentName
optional

string

city
optional

string

closedAt
optional

Timestamp

closingDate
optional

Timestamp

expirationDate
optional

Timestamp

id
optional

integer(int64)

price
optional

number

representing
optional

string

state
optional

string

status
optional

string

transactionType
optional

string

zip
optional

string

6.30. Item

Name Schema

name
optional

string

type
optional

string

value
optional

string

6.31. JsonNode

Type : object

6.32. LeadActivityReq

Name Description Schema

created
required

created time in milliseconds
Example : 1518078026000

integer(int64)

link
required

Url for web page
Example : "https://lofty.com"

string

listing
optional

Listing details

LeadPropertyReq

pageName
optional

The page name of the lead’s submission(re-inquiry) page
Example : "Blog Registration"

string

picture
required

Preview picture url
Example : "https://lofty.com/default.jpg"

string

scheduledDate
optional

Scheduled date about this showing request

string

text
required

Search Text
Example : "Search"

string

type
required

Type, Search, Browse, Favorite, Request, Submission
Example : "Search"

string

6.33. LeadActivityRes

Name Description Schema

created
required

created time in milliseconds
Example : 1518078026000

integer(int64)

link
required

Url for web page
Example : "https://lofty.com"

string

listing
optional

Listing details

LeadPropertyRes

pageName
optional

The page name of the lead’s submission(re-inquiry) page
Example : "Blog Registration"

string

picture
required

Preview picture url
Example : "https://lofty.com/default.jpg"

string

scheduledDate
optional

Scheduled date about this showing request

string

text
required

Search Text
Example : "Search"

string

type
required

Type, Search, Browse, Favorite, Request, Submission
Example : "Search"

string

6.34. LeadAssigineeRequest

Name Description Schema

assiginee
optional

Account of assignee
Example : "info@lofty-mail.me"

string

role
required

Role, Agent, Assistant, Lender
Example : "Agent"

string

6.35. LeadAssigneeRequest

Name Description Schema

birthday
optional

The birthday of the lead(pattern:MMM d, yyyy)
Example : "Jun 5, 2001"

string

email
required

The email address associated with the lead
Example : "123456789@gmail.com"

string

firstName
required

The first name of the lead
Example : "Bob"

string

lastName
optional

The last name of the lead
Example : "Li"

string

phone
optional

The phone number associated with the lead. (No more than 20 characters per phone)
Example : "1234567890"

string

6.36. LeadCustomRoleAssigneeInfo

Name Description Schema

customRoleAssignees
optional

lead customRoleAssignees

< CustomRoleAssignee > array

firstName
optional

lead firstName

string

lastName
optional

lead lastName

string

leadId
optional

leadId

integer(int64)

leadUserId
optional

leadUserId

integer(int64)

6.37. LeadFamilyMember

Name Description Schema

birthday
optional

The birthday of the family member(pattern:MMM d, yyyy)

string

emails
optional

A list of email addresses associated with the lead

< string > array

firstName
required

The first name of the family member

string

lastName
optional

The last name of the family member

string

phones
optional

A list of phone numbers associated with the family member. (No more than 20 characters per phone)

< string > array

relationship
optional

The relationship of this family member to primary lead. Example: Husband

string

6.38. LeadInquiryReq

Name Description Schema

bathroomsMax
optional

string

bathroomsMin
optional

Bath Rooms
Example : "1"

string

bedroomsMax
optional

integer(int32)

bedroomsMin
optional

Bed Rooms
Example : 1

integer(int32)

createTime
optional

string(date-time)

id
optional

integer(int64)

leadUserId
optional

integer(int64)

locations
optional

Locations

< Location > array

modifyByAgent
optional

boolean

priceMax
optional

Price range higher end
Example : 10000000

integer(int64)

priceMin
optional

Price range lower end
Example : 1

integer(int64)

propertyType
optional

Property types: Single Family Home, Multi-Family, Condo, Townhouse, Mobile Home, Manufactured Home, Vacant Land, Commercial.

< string > array

updateTime
optional

string(date-time)

6.39. LeadInquiryRes

Name Description Schema

bathroomsMax
optional

string

bathroomsMin
optional

Bath Rooms
Example : "1"

string

bedroomsMax
optional

integer(int32)

bedroomsMin
optional

Bed Rooms
Example : 1

integer(int32)

createTime
optional

string(date-time)

defaultValue
optional

boolean

id
optional

integer(int64)

leadUserId
optional

integer(int64)

locations
optional

Locations

< Location > array

modifyByAgent
optional

boolean

priceMax
optional

Price range higher end
Example : 10000000

integer(int64)

priceMin
optional

Price range lower end
Example : 1

integer(int64)

propertyType
optional

Property types: Single Family Home, Multi-Family, Condo, Townhouse, Mobile Home, Manufactured Home, Vacant Land, Commercial.

< string > array

updateTime
optional

string(date-time)

6.40. LeadListResponse

Name Schema

_metadata
optional

MetaData

leads
optional

< LeadResponse > array

6.41. LeadPond

Name Description Schema

agentIds
optional

The accessible agent id of the lead pond, It’s a list with user ids

< integer(int64) > array

id
required

The id of this lead pond

integer(int64)

pondName
required

The name of this lead pond

string

pondOwnerId
required

The owner user id of the lead pond

integer(int64)

6.42. LeadPropertyReq

Name Description Schema

autoListingId
optional

integer(int64)

bathrooms
optional

The bath rooms.
Example : 2.0

number(double)

bedrooms
optional

The bed rooms.
Example : 3

integer(int32)

city
optional

The city
Applies to lead routing only if the leadType field is Seller(1)
Example : "New York"

string

county
optional

The county
Applies to lead routing only if the leadType field is Seller(1)

string

floors
optional

The floors.
Example : 1

integer(int32)

id
optional

integer(int64)

label
optional

string

labelList
optional

string

labelType
optional

string

leadUserId
optional

integer(int64)

listingId
optional

string

listingStatus
optional

string

lotSize
optional

The lot size (acreage).
Example : 26.33

number(double)

mailAddress
optional

Mailing address

boolean

note
optional

string

parkingSpace
optional

The parking space.
Example : 1

integer(int64)

pictureUrl
optional

string

price
optional

The price
Applies to lead routing only if the leadType field is Seller(1)
Example : 100000

integer(int64)

priceMax
optional

The max price
Applies to lead routing only if the leadType field is Seller(1)
Example : 10000000

integer(int64)

priceMin
optional

The min price
Applies to lead routing only if the leadType field is Seller(1)
Example : 100000

integer(int64)

propertyType
optional

Property type: Single Family Home, Multi-Family, Condo, Townhouse, Mobile Home, Manufactured Home, Vacant Land, Commercial.
Example : "Single Family Home"

string

siteListingUrl
optional

string

squareFeet
optional

The square feet.
Example : 100

integer(int64)

state
optional

The state
Applies to lead routing only if the leadType field is Seller(1)
Example : "California"

string

streetAddress
optional

The street address
Applies to lead routing only if the leadType field is Seller(1)
Example : "22348 Regnart RD"

string

zipCode
optional

The zip code
Applies to lead routing only if the leadType field is Seller(1)
Example : "25401"

string

6.43. LeadPropertyRes

Name Description Schema

autoListingId
optional

integer(int64)

bathrooms
optional

The bath rooms.
Example : 2.0

number(double)

bedrooms
optional

The bed rooms.
Example : 3

integer(int32)

city
optional

The city
Applies to lead routing only if the leadType field is Seller(1)
Example : "New York"

string

county
optional

The county
Applies to lead routing only if the leadType field is Seller(1)

string

floors
optional

The floors.
Example : 1

integer(int32)

id
optional

integer(int64)

label
optional

string

labelList
optional

string

labelType
optional

string

leadUserId
optional

integer(int64)

listingId
optional

string

listingStatus
optional

string

lotSize
optional

The lot size (acreage).
Example : 26.33

number(double)

mailAddress
optional

Mailing address

boolean

note
optional

string

parkingSpace
optional

The parking space.
Example : 1

integer(int64)

pictureUrl
optional

string

price
optional

The price
Applies to lead routing only if the leadType field is Seller(1)
Example : 100000

integer(int64)

propertyType
optional

Property type: Single Family Home, Multi-Family, Condo, Townhouse, Mobile Home, Manufactured Home, Vacant Land, Commercial.
Example : "Single Family Home"

string

siteListingUrl
optional

string

squareFeet
optional

The square feet.
Example : 100

integer(int64)

state
optional

The state
Applies to lead routing only if the leadType field is Seller(1)
Example : "California"

string

streetAddress
optional

The street address
Applies to lead routing only if the leadType field is Seller(1)
Example : "22348 Regnart RD"

string

zipCode
optional

The zip code
Applies to lead routing only if the leadType field is Seller(1)
Example : "25401"

string

6.44. LeadRequest

Name Description Schema

assignGroupId
optional

Pass the Group id value to specify the routing rule for a certain scope. If set to -1, the lead will be to company routing rule .

integer(int64)

assignedUserId
optional

Id of the agent assigned to this contact
Example : 10000000514

integer(int64)

birthday
optional

The birthday of the lead(pattern:MMM d, yyyy)
Example : "Jun 5, 2001"

string

buyHouse
optional

Buy a house, Yes or No.
Example : "Yes"

string

buyingTimeFrame
optional

buying time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example : "6-12"

string

cannotCall
optional

false: can call to the lead

boolean

cannotEmail
optional

false: can email to the lead

boolean

cannotText
optional

false: can send message to the lead

boolean

city
optional

The city associated with the lead
Not applicable for lead routing
Example : "Washington DC"

string

content
optional

Note content
Example : "example_note"

string

customAttributeList
optional

User customized field

< CustomAttribute > array

emails
optional

A list of email addresses associated with the lead

< string > array

firstName
required

The first/given name of the lead
Caution: Max limit 30 characters. If you exceed the limit, the import will succuss, but only import 30 characters in front.
Example : "Bob"

string

fthb
optional

first time home buyer, Yes or No.
Example : "Yes"

string

groups
optional

The groups the lead is in
Caution: Max limit 30 characters.If you exceed the limit,the import will success , but only import 30 characters in front. deprecated, use segments instead.

< string > array

houseToSell
optional

House to Sell, Yes or No.
Example : "Yes"

string

inquiry
optional

The inquiry of the lead

LeadInquiryReq

isPin
optional

Pin this note or not
Example : false

boolean

language
optional

The lead’s abbreviated language, en, fr, de, es, zh-CN, zh-TW, ja
Example : "en"

string

lastName
optional

The last/family name of the lead
Caution: Max limit 30 characters. If you exceed the limit, the import will succuss, but only import 30 characters in front.
Example : "Li"

string

leadAlert
optional

send new lead alert email. (Not supporting update)

boolean

leadFamilyMemberList
optional

A list of family members associated with the lead. You can add up to 4 family members.

< LeadFamilyMember > array

leadTransaction
optional

LeadTransaction

leadType
optional

Type of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Buyer & Seller (3), Renter (5)
Example : -1

integer(int32)

leadTypes
optional

Types of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Renter (5), Investor (6), Agent (7), Homeowner (8), Landlord (9)

< integer(int32) > array

mortgage
optional

Mortgage, Yes or No.
Example : "Yes"

string

ownershipId
optional

Specific owner id of lead, such as office id and agent id.

integer(int64)

ownershipScope
optional

Ownership level of lead. (If it is office or personal, you need to pass a value to ownershipID to specify the entity.)
Example : "TEAM, OFFICE, PERSONAL"

string

phones
optional

A list of phone numbers associated with the lead. (No more than 20 characters per phone)

< string > array

preQual
optional

Pre-qual, Yes or No.
Example : "Yes"

string

property
optional

The property of the lead.

LeadPropertyReq

referredBy
optional

The referee of the lead
Example : "Jeremy Kelly"

string

segments
optional

The segments the lead is in
Caution: Max limit 30 characters.If you exceed the limit,the import will success , but only import 30 characters in front.

< string > array

sellingTimeFrame
optional

selling time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example : "1-3"

string

source
optional

The source of the lead
Example : "Open House"

string

stage
optional

The stage the lead is in, less than 20 characters
Example : "Pending"

string

state
optional

The state associated with the lead
Not applicable for lead routing
Example : "Washington DC"

string

streetAddress
optional

The streetAddress associated with the lead
Example : "The White House,1600 Pennsylvania Avenue NW"

string

tags
optional

The tags associated with the lead. All existing tags will be updated based on this call
Caution: Max limit 64 characters.If you exceed the limit,the import will success , but only import 64 characters in front.

< string > array

tagsAdd
optional

The tags associated with the lead. All existing tags will be retained, only add new tags base on this call
Caution: Max limit 64 characters. If you exceed the limit, the import will success, but only import 64 characters in front.

< string > array

unsubscription
optional

Unsubscription the email

boolean

welcomeEmail
optional

send Welcome Email. (Not supporting update)

boolean

withBuyerAgent
optional

With buyer Agent, Yes or No.
Example : "Yes"

string

withListingAgent
optional

With listing agent, Yes or No.
Example : "Yes"

string

zipCode
optional

ZipCode
Not applicable for lead routing
Example : "20500"

string

6.45. LeadResponse

Name Description Schema

assignCompletionStatus
optional

Whether complete all lead assign process

boolean

assignTime
optional

The assigned time of the lead

string

assignedUser
optional

The Username of the lead assigned to

string

assignedUserId
optional

The user Id of the lead assigned to

integer(int64)

birthday
optional

The birthday of the lead

string

buyHouse
optional

Buy a house, Yes or No.
Example : "Yes"

string

buyingTimeFrame
optional

buying time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example : "6-12"

string

cannotCall
optional

false: can call to the lead

boolean

cannotEmail
optional

false: can email to the lead

boolean

cannotText
optional

false: can send message to the lead

boolean

city
optional

The city associated with the lead

string

createTime
optional

The create time of the lead

string

customAttributes
optional

User customized field

< CustomAttribute > array

customRoleList
optional

< CustomRole > array

emails
optional

The email list of the lead

< string > array

facebook
optional

The Facebook account of the lead

string

firstName
optional

The first/given name of the lead

string

fthb
optional

first time home buyer, Yes or No
Example : "Yes"

string

groups
optional

The groups that the lead in. deprecated, use segments instead.

< string > array

hiddenFlag
optional

The lead is hidden or not

boolean

houseToSell
optional

House to Sell, Yes or No
Example : "Yes"

string

language
optional

The language of the lead

string

lastName
optional

The last/family name of the lead

string

lastTouch
optional

The last touch time of the lead

string

lastUpdateTime
optional

The update time of the lead

string

lastVisit
optional

The last visit time of the lead

string

leadFamilyMemberList
optional

A list of family members associated with the lead

< LeadFamilyMember > array

leadId
optional

The Id of the lead

integer(int64)

leadInquiry
optional

LeadInquirys

LeadInquiryRes

leadPropertyList
optional

LeadPropertyList

< LeadPropertyRes > array

leadSource
optional

The leadSource(Id) about the lead

integer(int32)

leadType
optional

Type of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Buyer & Seller (3)

integer(int32)

leadTypes
optional

Types of lead, expressed by ID. Type ID : Other (-1), Seller (1), Buyer (2), Renter (5), Investor (6), Agent (7), Homeowner (8), Landlord (9)

< integer(int32) > array

leadUserId
optional

The user Id of the lead

integer(int64)

lenderUserId
optional

The user Id of the lead’s lender

integer(int64)

mortgage
optional

Mortgage, Yes or No.
Example : "Yes"

string

opportunity
optional

The opportunity type of the lead
Example : "High Interest"

string

ownershipId
optional

integer(int64)

ownershipScope
optional

string

phoneStatuses
optional

The status of the phone number
Type id: invaild number(1), vaild number(2), talked(3), DNC Number(4), DNC Contact(5)

< integer(int32) > array

phones
optional

The phone list of the lead

< string > array

pondId
optional

The Id of the lead’s pond

integer(int64)

pondName
optional

The Name of the lead’s pond

string

preQual
optional

Pre-qual, Yes or No
Example : "Yes"

string

referredBy
optional

The referee of the lead

string

score
optional

The score of the lead

integer(int32)

segments
optional

The segments that the lead in

< string > array

sellingTimeFrame
optional

selling time frame, 1-3, 3-6, 6-12, 12+, Just Looking, Refinancing.
Example : "1-3"

string

source
optional

The source of the lead

string

stage
optional

The stage of the lead

string

stageId
optional

The stageId of the lead

integer(int64)

state
optional

The state associated with the lead

string

streetAddress
optional

The streetAddress associated with the lead

string

tags
optional

The tags of the lead

< UserLeadTagVo > array

teamId
optional

The teamId of the lead’s team

integer(int64)

twitter
optional

The Twitter account of the lead

string

unsubscription
optional

Unsubscription the email

boolean

withBuyerAgent
optional

With buyer Agent, Yes or No
Example : "Yes"

string

withListingAgent
optional

With listing agent, Yes or No.
Example : "Yes"

string

zipCode
optional

The zip code associated with the lead

string

6.46. LeadTransaction

Name Description Schema

agentRevenue
optional

The agent revenue of transaction
Example : 4000.0

number

agreementSignedDate
optional

integer(int64)

appointmentDate
optional

integer(int64)

appraisalDate
optional

integer(int64)

assignedAgent
optional

Lead’s assigned agent (not support updating)

integer(int64)

closeDate
optional

The closed date of transaction
Example : 1508580010000

integer(int64)

commissionRate
optional

The commission rate of transaction
Example : 3.0

number

commissions
optional

Split Commissions

Commissions

contractDate
optional

integer(int64)

created
required

created time in milliseconds
Example : 1518078026000

integer(int64)

customFields
optional

Custom field full coverage update or insertion

< CustomFieldRequest > array

escrowDate
optional

integer(int64)

expectedCloseDate
optional

The expected close date of transaction
Example : 1508580010000

integer(int64)

expiration
optional

integer(int64)

gci
optional

The GCI of transaction
Example : 5000.0

number

homeInspectionDate
optional

integer(int64)

homePrice
optional

The home price of transaction
Example : 1000000.0

number

leadName
optional

Lead’s name whom the transaction is assigned to (not support updating)
Example : "Bob"

string

offerDate
optional

integer(int64)

teamRevenue
optional

The team revenue of transaction
Example : 1000.0

number

transactionId
optional

integer(int64)

transactionName
required

Property Address/Transaction Name
Example : "123 Main St"

string

transactionStatus
optional

The status of transaction
Example : "Pre-contract"

string

transactionType
optional

The type of Transaction:Purchase, Listing
Example : ""

string

updated
required

updated time in milliseconds (not support updating)
Example : 1518078026000

integer(int64)

6.47. LeadTransactionPropertyAddress

Name Description Schema

city
optional

The city
Example : "Los Angeles"

string

county
optional

The county
Example : "Log Angeles"

string

label
optional

The label
Example : "Investment"

string

state
optional

The state
Example : "CA"

string

streetAddress
optional

The street address
Example : "100 W 1st St"

string

transactionId
optional

integer(int64)

unit
optional

The unit
Example : "1"

string

zipCode
optional

The zip code
Example : "90012"

string

6.48. LinkRequest

Name Schema

leadId
optional

integer(int64)

loftyWebsiteURL
optional

string

6.49. Location

Name Description Schema

city
optional

The city
Applies to lead routing if the leadType field is not Seller(1) in the lead creation request.
Example : "Palm Desert"

string

county
optional

The county
Applies to lead routing if the leadType field is not Seller(1) in the lead creation request.

string

description
optional

Description of location.
Example : "other"

string

stateCode
optional

The state code of city
Applies to lead routing if the leadType field is not Seller(1) in the lead creation request.
Example : "CA"

string

streetAddress
optional

The street address
Applies to lead routing if the leadType field is not Seller(1) in the lead creation request.

string

zipCode
optional

The zip code
Applies to lead routing if the leadType field is not Seller(1) in the lead creation request.
Example : "92211"

string

6.50. LocationRule

Name Description Schema

city
optional

City setting

string

county
optional

County setting

string

locationMatchType
optional

Location match type
Example : "MATCH_EXACTLY(1),EMPTY_OR_MATCH(2);"

integer(int32)

state
optional

State setting
Example : "NL"

string

streetAddress
optional

StreetAddress setting

string

zipcode
optional

Zipcode setting

string

6.51. LogTypeRequest

Name Description Schema

callingOutcome
optional

Talked,VoiceMessage,NoAnswer,BadNumber,DNCNumber,DNCContact
Example : "VoiceMessage"

string

content
required

log type content
Example : "example log content"

string

isPin
optional

Pin this activity or not
Example : false

boolean

leadId
required

The ID of the lead this log type is related to
Example : 563172647619608

integer(int64)

leadPhoneNumber
optional

The value of the lead phone number
Example : "586****860"

string

logType
required

values:logCall,logEmail,logText
Example : "logCall"

string

outboundOrInbound
optional

Outbound or inbound communication
Example : "outbound','inbound"

string

6.52. LogTypeResponse

Name Description Schema

agentId
optional

Operator’s agent id

integer(int64)

callingOutcome
optional

Calling Outcome value:Talked,VoiceMessage,NoAnswer,BadNumber,DNCNumber,DNCContact

string

createTime
optional

The create time of log type

string

id
optional

The Id of the log type

integer(int64)

isPin
optional

Pin this activity or not

boolean

leadId
optional

The lead(Id) associated with the call/email/text

integer(int64)

leadPhoneNumber
optional

The lead phone number

string

outboundOrInbound
optional

Outbound or inbound communication

string

6.53. MemberListResponse

Name Schema

_metadata
optional

MetaData

members
optional

< UserResponse > array

6.54. MemberWeight

Name Description Schema

firstName
optional

Member first name, edit don’t need this param

string

lastName
optional

Member last name, edit don’t need this param

string

memberId
optional

Member id

integer(int64)

weight
optional

Member weight

integer(int32)

6.55. MetaData

Name Description Schema

collection
optional

The element of the array
Example : "note"

string

limit
optional

Quantitative limitation of responded elements
Example : 10

integer(int32)

offset
optional

Start index of the responded elements
Example : 0

integer(int64)

scrollId
optional

Scroll ID for the search. You can then use the scroll ID to retrieve the next batch of results for the request.

string

total
optional

The sum of retrieved elements
Example : 50

integer(int64)

6.56. MultiTeamInfo

Name Description Schema

multiTeamId
optional

Mult-Team ID

integer(int64)

multiTeamName
optional

Multi-Team Name

string

6.57. NoteRequest

Name Description Schema

content
required

Note content
Example : "example_note"

string

isPin
optional

Pin this note or not
Example : false

boolean

leadId
required

The ID of the lead this note is related to
Example : 563172647619608

integer(int64)

6.58. NoteResponse

Name Description Schema

content
optional

The content of the note

string

createTime
optional

The create time of the note

string

creatorId
optional

The user Id of the note’s creator

integer(int64)

creatorName
optional

The creator’s name of the note

string

deleteFlag
optional

If the note is deleted of not

boolean

id
optional

The Id of the timeline

integer(int64)

isPin
optional

Pin this note or not

boolean

lastEditorId
optional

The last user Id to edit the note

integer(int64)

lastEditorName
optional

The last editor’s name of the note

string

lastUpdate
optional

The last update time of the note

string

leadId
optional

The lead(Id) associated with the note

integer(int64)

noteId
optional

The Id of the note

integer(int64)

systemNote
optional

Is system note or not

boolean

6.59. OauthTokenInfo

Name Description Schema

refreshToken
optional

refresh token value

string

refreshTokenExpireTime
optional

The expire time of the refreshtoken

Timestamp

token
optional

token value

string

tokenExpireTime
optional

The expire time of the token

Timestamp

6.60. OfficeOpenVo

Name Schema

allowManageSub
optional

boolean

city
optional

string

email
optional

string

id
optional

integer(int64)

name
optional

string

parentId
optional

integer(int64)

phone
optional

string

phoneCode
optional

string

phoneCountry
optional

string

state
optional

string

streetAddress
optional

string

websiteOwnerId
optional

integer(int64)

zipcode
optional

string

6.61. OpportunityNotificationRequest

Name Description Schema

description
optional

description and link is a combo, only if you fill bath of them, they will show on the notification
Example : "San Francisco, CA 94102"

string

leadId
required

the id of lead
Example : 1

integer(int64)

link
optional

description and link is a combo, only if you fill bath of them, they will show on the notification

string

message
optional

the message show on notification

string

notificationType
required

the notificationType contains flow:
48-Viewed a listing 3 times;
50-Searched;
52-Saved a listing;
46-Requested to sell a house;
47-Requested home evaluation;
65-Left a message;
66-Requested a showing;
27-Saved a search;
89-Used mortgage;
calculator for multiple times; 165-Re-inquired on text code;
166-back to site - View a listing;
162-Request CMA;
164-requested financing options;
167-Submit a form;
168-Viewed CMA
Example : 48

integer(int32)

6.62. OrganizationInfo

Name Description Schema

enterpriseInfo
optional

If the client is on the "Enterprise Package," the enterprise organization structure will be returned. Refer to "EnterpriseInfo."

object

multiTeamInfo
optional

If the client is on the "Multi-Team Package," the Multi-Team info will be returned.

object

orgType
optional

Organization type
Example : "SIGNAL_INSTANCE(1), MULTI_TEAM(2)"

integer(int64)

6.63. PageResult

Name Description Schema

hasMore
optional

has more
Example : true

boolean

limit
optional

limit
Example : 500

integer(int32)

offset
optional

current offset
Example : 0

integer(int32)

pageData
optional

page data

< CommunicationResponse > array

6.64. PermissionProfile

Name Description Schema

id
optional

The Profile Id

integer(int64)

name
optional

The Profile Name

string

6.65. PersonalPhotos

Name Schema

urls
optional

< string > array

6.66. Result«long»

Name Schema

data
optional

integer(int64)

errorCode
optional

integer(int32)

errorData
optional

JsonNode

errorMsg
optional

string

6.67. RoutingRule

Name Description Schema

activeHours
optional

Active hours setting

object

groupMatchType
optional

Group match type
Example : "MATCH_EXACTLY(1),EMPTY_OR_MATCH(2);"

integer(int32)

groupNames
optional

Lead segment name list

< string > array

id
optional

Rule id

integer(int64)

leadType
optional

lead type
Example : "Other(-1),Seller(1),Buyer(2),B&S(3),Renter(5)"

string

leadTypeFilters
optional

multi lead type
Example : ""

string

locationRule
optional

Location rule

object

name
optional

Rule name

string

phone
optional

Phone setting
Example : "With’、'Without’、 '"

string

priceMax
optional

Price max

integer(int64)

priceMin
optional

Price min

integer(int64)

routingStrategy
optional

Active hours setting

object

ruleSwitch
optional

Rule switch

boolean

sourceMatchType
optional

Lead source name
Example : "MATCH_EXACTLY(1),EMPTY_OR_MATCH(2);"

integer(int32)

sourceName
optional

Lead source name

string

tagMatchType
optional

Tag match type
Example : "MATCH_EXACTLY(1),EMPTY_OR_MATCH(2);"

integer(int32)

tagNames
optional

Lead tag name list

< string > array

updateTime
optional

Update time

integer(int64)

6.68. RoutingRuleRequest

Name Description Schema

activeHours
optional

Active hours setting

object

id
optional

Rule id

integer(int64)

routingStrategy
optional

Active hours setting

object

6.69. RoutingStrategy

Name Description Schema

groupId
optional

Only lead pond are affected

integer(int64)

groupName
optional

Edit method don’t need this params

string

memberWeights
optional

Except for the lead pond type

object

strategyType
optional

Strategy type
Example : "Next Up(1), Blast Alert(2), Round Robin(3), Lead Pond(4)"

integer(int32)

touchMinutes
optional

Only next up and blast alert are affected

integer(int32)

6.70. SocialMedias

Name Schema

items
optional

< Item > array

6.71. SupplementRoutingRule

Name Description Schema

assigneeAgentId
optional

Only default assignee are affected

string

assigneeAgentName
optional

Only default assignee are affected

string

assigneeGroupId
optional

Only default assignee are affected

string

assigneeGroupName
optional

Only default assignee are affected

string

businessType
optional

Routing type
Example : "AGENT_LEAD(1), LENDER_LEAD(2), ASSISTANT_LEAD(4);"

integer(int32)

roleId
optional

Role id

integer(int32)

strategyType
optional

Strategy type
Example : "Next_Up(1), BLAST_ALERT(2), DEFAULT_ASSIGNEE(3);"

integer(int32)

touchMinutes
optional

Only next up and blast alert are affected

integer(int32)

updateTime
optional

Update time

integer(int64)

6.72. SupplementRoutingRuleRequest

Name Description Schema

assigneeAgentId
optional

Only default assignee are affected

integer(int64)

assigneeGroupId
optional

Only default assignee and routing type is AGENT_LEAD are affected

integer(int64)

roleId
optional

Role id, This parameter is required when type == 4

integer(int32)

strategyType
optional

Strategy type
Example : "Next_Up(1), BLAST_ALERT(2), DEFAULT_ASSIGNEE(3);"

integer(int32)

touchMinutes
optional

Only next up and blast alert are affected

integer(int32)

6.73. SystemLogResponse

Name Description Schema

agentId
optional

The id of the agent

integer(int64)

canSticky
optional

canSticky

boolean

content
optional

content(JSON)

string

createTime
optional

The timestamp of the create time

integer(int64)

fromFirstName
optional

The first name of the FROM

string

fromId
optional

The id of the FROM

integer(int64)

fromLastName
optional

The last name of the FROM

string

fromType
optional

The type of the FROM

integer(int32)

id
optional

id

integer(int64)

leadFullName
optional

The full name of the lead

string

leadId
optional

The id of the lead

integer(int64)

sticky
optional

sticky

boolean

timelineTime
optional

The timestamp of the timeline

integer(int64)

timelineType
optional

The type of the timeline

integer(int32)

toFirstName
optional

The first name of the TO

string

toId
optional

The id of the TO

integer(int64)

toLastName
optional

The last name of the TO

string

toType
optional

The type of the TO

integer(int32)

updateTime
optional

The timestamp of the update time

integer(int64)

6.74. TaskRequest

Name Description Schema

assignedRole
optional

Role the task should be assigned to (Agent Or Assistant)
Example : "Agent"

string

content
optional

Description of the task
Example : "Send an email to my lead"

string

deadline
optional

Deadline of the task
Example : 1508580010000

integer(int64)

finishFlag
optional

Indicates whether the task is completed.
Example : true

boolean

leadId
optional

The ID of the lead this task is related to.
Example : 563172647619608

integer(int64)

type
optional

The type of the task. Could be Other, Call, Email, Text
Example : "Call"

string

6.75. TaskResponse

Name Description Schema

assignedRole
optional

The role of the task assigned to

string

assignedUser
optional

The user of the task assigned to

string

assignedUserId
optional

The user’s Id of the task assigned to

integer(int64)

body
optional

The body of the task

string

content
optional

The content of the task

string

createTime
optional

The create time of the task

string

creatorId
optional

The creator’s Id of the task

integer(int64)

deadline
optional

The deadline of the task

string

deleteFlag
optional

If the task is deleted or not

boolean

finishFlag
optional

If the task is finished or not

boolean

finishTime
optional

The finish time of the task

string

id
optional

The Id of the task

integer(int64)

lastUpdate
optional

The last update time of the task

string

leadEmail
optional

The lead’s email associated with the task

string

leadFirstName
optional

The lead’s first name of the task

string

leadId
optional

The lead(Id) associated with the task

integer(int64)

leadLastName
optional

The lead’s last name of the task

string

leadName
optional

The lead’s name associated with the task

string

leadPhone
optional

The lead’s phone associated with the task

string

leadUserId
optional

The lead’s user Id associated with the task

integer(int64)

overdueFlag
optional

If the task is overdue or not

boolean

pipelineId
optional

The pipeline(Id) of the associated lead

integer(int64)

queryId
optional

The queryId of the task

integer(int64)

queryInfo
optional

The queryInfo of the task

string

reminderType
optional

The reminder’s type of the task

integer(int32)

subject
optional

The subject of the task

string

teamId
optional

The team’s Id associated with the task

integer(int64)

type
optional

The type of the task

string

6.76. TextResponse

Name Description Schema

agentId
optional

The related Agent ID

integer(int64)

direction
optional

Outbound or Inbound text
Example : "Outbound"

string

id
optional

The ID of the text

integer(int64)

leadId
optional

The lead(Id) associated with the text

integer(int64)

textOutcome
optional

Text delivery status
Example : "Delivered"

string

textTime
optional

The sending time of the text

string

textType
optional

Manual or Auto text
Example : "Auto"

string

6.77. Timestamp

Name Schema

date
optional

integer(int32)

day
optional

integer(int32)

hours
optional

integer(int32)

minutes
optional

integer(int32)

month
optional

integer(int32)

nanos
optional

integer(int32)

seconds
optional

integer(int32)

time
optional

integer(int64)

timezoneOffset
optional

integer(int32)

year
optional

integer(int32)

6.78. UserLeadTag

Name Schema

createTime
optional

string(date-time)

creatorUserId
optional

integer(int64)

leadId
optional

integer(int64)

tagId
optional

integer(int64)

tagName
optional

string

updateTime
optional

string(date-time)

visibleType
optional

integer(int32)

6.79. UserLeadTagVo

Name Schema

createTime
optional

string

creatorUserId
optional

integer(int64)

leadId
optional

integer(int64)

tagId
optional

integer(int64)

tagName
optional

string

updateTime
optional

string

visibleType
optional

integer(int32)

6.80. UserRequest

Name Description Schema

agentInfo
optional

The agent infomation of the user

AgentInfo

email
optional

The email of the member
Example : "roseTest@lofty.com"

string

firstName
optional

The firstName of the member
Example : "Rose"

string

headPortrait
optional

The head portrait of the member
Example : "https://cdn.chime.me/image/fs/user-info/2019122/16/original_6e611e6d-0416-42e6-ba74-b077d55a1129.png"

string

lastName
optional

The lastName of the member
Example : "Bob"

string

phoneNumber
optional

The phone number of the member
Example : "19022342233"

string

timeZoneId
optional

The time zone of the member. timeZoneId: "America/Halifax",
"America/New_York",
"America/Chicago",
"America/Denver",
"America/Los_Angeles",
"America/Anchorage",
"America/Adak",
"US/Arizona",
"Asia/Hong_Kong"
Example : "America/Los_Angeles"

string

6.81. UserResponse

Name Description Schema

accountStatus
optional

string

agentInfo
optional

The agent infomation of the user

AgentInfo

assignedLeadCount
optional

The count about assigned leads of the member

integer(int32)

email
optional

The email of the member

string

firstLetter
optional

The firstLetter of the member

string

firstName
optional

The firstName of the member

string

groupId
optional

The group id of the member

integer(int64)

groupName
optional

The group name of the member

string

id
optional

The Id of the team’s member

integer(int64)

invitorUserId
optional

The user Id of the member invited by

integer(int64)

isAdmin
optional

If the member is admin or not

boolean

lastName
optional

The lastName of the member

string

memberUserId
optional

The user Id of the member

integer(int64)

newLeadCount
optional

The count about new leads of the member

integer(int32)

phoneNumber
optional

The phone number of the member

string

role
optional

The role(Id) of the member

integer(int32)

roleName
optional

The role(name) of the member

string

status
optional

The status of the member

integer(int32)

timeZoneId
optional

The agent timezoneId

string

virtualNumber
optional

The virtual number of the member

string

6.82. VendorInfo

Name Description Schema

agentUserId
optional

Agent user ID

integer(int64)

companyAddress
optional

The company name of the vendor

string

companyName
optional

The company name of the vendor

string

email
optional

The email of the vendor

string

firstName
optional

The first name of the vendor

string

id
optional

The ID of the vendor
Example : 11

integer(int64)

lastName
optional

The last name of the vendor

string

phoneCode
optional

The phone code of the vendor

string

phoneCountry
optional

The phone country of the vendor

string

phoneNumber
optional

The phone number of the vendor

string

roleName
optional

The role name of the vendor

string

6.83. VisibleOrgInfo

Name Description Schema

groupId
optional

Group ID

integer(int64)

groupName
optional

Group Name

string

parentId
optional

Parent Group ID

integer(int64)

6.84. WebhookRequest

Name Description Schema

callbackUrl
required

The url link that you receive information
Example : "http://xxx.test.com"

string

limit
optional

limitation of webhook notifications in 30 mins for each, max is 5000
Example : 100

integer(int32)

listId
required

The list that you want to subscribe.
ListId: agent info(1), lead info(2), lead activity(3), alert(4), transaction(5), call(6), email(7), text(8), note(9), task(10), appointment(11),changePipeline(12)

integer(int32)

6.85. WebhookResponse

Name Description Schema

callbackUrl
required

The url link that you receive information
Example : "http://xxx.test.com"

string

limit
optional

limitation of webhook notifications in 30 mins for each, max is 5000
Example : 100

integer(int32)

listId
required

The ID of the list to get
Example : 1

integer(int32)

subscribeId
required

the subscribe id
Example : 1234

integer(int64)

teamId
required

The ID of the team to get
Example : 13233324

integer(int64)

vendorId
optional

The ID of the vendor
Example : 123

integer(int64)

6.86. WorkInfo

Name Description Schema

address
optional

address of the agent
Example : "NewYork"

string

companyAddress
optional

Company Address
Example : "xxx"

string

companyName
optional

Company Name
Example : "xxx"

string

licenseId
optional

licenseId of the agent
Example : "xxx"

string

personalAttachments
optional

< FileInfo > array

personalDisclaimers
optional

< FileInfo > array

personalIntroduction
optional

Personal Introduction
Example : "xxx"

string

personalWebsite
optional

Personal Website
Example : "xxx"

string

position
optional

position
Example : "xxx"

string