Get Sales Agent by lead ID

GET

v2.0

sales-agents

by-lead

curl --request GET \
  --url https://api.lofty.com/v2.0/sales-agents/by-lead \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.lofty.com/v2.0/sales-agents/by-lead"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.lofty.com/v2.0/sales-agents/by-lead', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lofty.com/v2.0/sales-agents/by-lead",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lofty.com/v2.0/sales-agents/by-lead"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.lofty.com/v2.0/sales-agents/by-lead")
  .header("Authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v2.0/sales-agents/by-lead")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "code": 0,
  "message": "success",
  "data": {}
}

"<string>"

"<string>"

"<string>"

"<string>"

Headers

Authorization

string

required

Bearer [access_token]

Query Parameters

leadId

integer<int64>

required

Lead ID

Response

Sales Agent found successfully

Sales Agent information

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"

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

Get current user's Sales Agent quota

Query Sales Agent settings

Get Sales Agent by lead ID

curl --request GET \
  --url https://api.lofty.com/v2.0/sales-agents/by-lead \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.lofty.com/v2.0/sales-agents/by-lead"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.lofty.com/v2.0/sales-agents/by-lead', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lofty.com/v2.0/sales-agents/by-lead",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lofty.com/v2.0/sales-agents/by-lead"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.lofty.com/v2.0/sales-agents/by-lead")
  .header("Authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v2.0/sales-agents/by-lead")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "code": 0,
  "message": "success",
  "data": {}
}

"<string>"

"<string>"

"<string>"

"<string>"

Leads

Task & Calendar

Transactions

Listings

Communication

Team

AI Copilot

Webhooks

Integrations

Headers

Query Parameters

Response