Skip to main content
GET
/
v2.0
/
sales-agents
/
by-lead
Get Sales Agent by lead ID
curl --request GET \
  --url https://api.lofty.com/v2.0/sales-agents/by-lead \
  --header 'Authorization: <authorization>'
{
  "id": 12345,
  "userId": 67890,
  "agentName": "John Doe",
  "agentHeadUrl": "https://example.com/avatar.jpg",
  "assistantName": "John's AI Assistant",
  "assistantHeadUrl": "https://example.com/ai-avatar.jpg",
  "virtualNumber": "+1234567890",
  "virtualNumberCountry": "US",
  "followUpRole": "buyer_agent",
  "agentExperience": "10 years in real estate",
  "email": "john.assistant@example.com",
  "status": "ACTIVE",
  "createdAt": "2026-02-20T10:00:00Z",
  "updatedAt": "2026-02-28T10:00:00Z",
  "hasQuotaSeat": true,
  "borrowLevel": "SELF",
  "borrowId": 12345
}

Documentation Index

Fetch the complete documentation index at: https://developer.lofty.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string
required

Bearer [access_token]

Query Parameters

​
leadId
integer<int64>
required

Lead ID

Response

Sales Agent found successfully

Sales Agent information

​
id
integer<int64>

Sales Agent ID

Example:

12345

​
userId
integer<int64>

User ID who owns this Sales Agent

Example:

67890

​
agentName
string

Agent's full name

Example:

"John Doe"

​
agentHeadUrl
string

Agent's avatar URL

Example:

"https://example.com/avatar.jpg"

​
assistantName
string

AI Assistant name

Example:

"John's AI Assistant"

​
assistantHeadUrl
string

AI Assistant avatar URL

Example:

"https://example.com/ai-avatar.jpg"

​
virtualNumber
string

Virtual phone number

Example:

"+1234567890"

​
virtualNumberCountry
string

Virtual number country code

Example:

"US"

​
followUpRole
string

Follow-up role: buyer_agent, listing_agent, etc.

Example:

"buyer_agent"

​
agentExperience
string

Agent experience description

Example:

"10 years in real estate"

​
email
string

AI Assistant email

Example:

"john.assistant@example.com"

​
status
string

Status: ACTIVE, INACTIVE, etc.

Example:

"ACTIVE"

​
createdAt
string

Creation time in ISO8601 format

Example:

"2026-02-20T10:00:00Z"

​
updatedAt
string

Last update time in ISO8601 format

Example:

"2026-02-28T10:00:00Z"

​
hasQuotaSeat
boolean

Whether AI has valid quota seat

Example:

true

​
borrowLevel
string

Borrow level if using borrowed AI: SELF, GROUP, TEAM

Example:

"SELF"

​
borrowId
integer<int64>

Borrowed from user/office ID

Example:

12345