← Home Get Seller Leads

Get Seller Leads

GEThttps://api.bayut.com/v1/leads

Retrieves a paginated list of Seller leads based on specified filters like channel, target, type, agency IDs, and date range. Each lead includes basic lead information, inquirer details, seller_lead_details and target details if applicable.

🔐 Bearer Token: Provide your bearer token in the Authorization header when making requests to protected resources.

Query Parameters

Name	Type	Required	Description	Example
channel	string	Optional	The source channel of the lead (e.g., whatsapp, website).	website
target	string	Optional	Lead target type (e.g., listing).	listing
type	string	Optional	Type of lead (e.g., seller).	seller
agency_ids[]	string	Optional	List of agency IDs to filter leads by specific agencies.
created_from	string	Optional	Start date for filtering leads (YYYY-MM-DD).	2025-10-01
created_to	string	Optional	End date for filtering leads (YYYY-MM-DD).	2025-10-08
page	string	Optional	Page number for pagination. Default: 1.	1
per_page	string	Optional	Number of items per page. max: 100.	50

Response Schema

Name	Type	Required
data	array[object]	Optional
lead	object	Optional
listing_details	object	Optional
inquirer_details	object	Optional
seller_lead_details	object	Optional
meta	object	Optional
current_page	integer	Optional
from	integer	Optional
to	integer	Optional
total	integer	Optional

Responses

200✅

422⚠️

Code Examples

curl --location --globoff 'https://api.bayut.com/v1/leads?channel=website&target=listing&type=seller&agency_ids[]=&created_from=2025-10-01&created_to=2025-10-08&page=1&per_page=50' \
--header 'Authorization: Bearer <token>'

{
    "data": [
        {
            "lead": {
                "id": "seller-leads|9efa6cf1-b3d1-4d77-a823-d25f51415cd9",
                "source": "bayut",
                "target": "listing",
                "channel": "website",
                "date_time": "2025-10-27 16:20:34"
            },
            "listing_details": {
                "id": 0,
                "reference": null,
                "category": null
            },
            "inquirer_details": {
                "name": "22223",
                "cell": "+40711111111",
                "email": null,
                "message": null
            },
            "seller_lead_details": {
                "unlocked_date_time": "2025-10-27 16:25:34",
                "intent": "For Sale",
                "property_type": "Villa",
                "location": "Deira",
                "sub_location": "Deira",
                "owner_expecting_price_aed": 300000,
                "bedrooms": "3",
                "built_up_area_sqft": 22222,
                "furnishing_status": "-",
                "urgency_to_sell": "this_month",
                "notes": "-",
                "unlocked_by": "Alexandru Garbanzo",
                "assigned_to": "-",
                "contacted_status": "Yes"
            }
        }
    ],
    "meta": {
        "current_page": 0,
        "from": 1,
        "to": 1,
        "per_page": 1,
        "total": 60
    }
}