← Home Get Email Leads

Get Email Leads

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

Retrieves leads received through email related to listings.The is_lead parameter determines whether to fetch actual leads or view (non-lead) inquiries within the specified date range.

🔐 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., email).	email
target	string	Optional	Lead target type (e.g., listing).	listing
is_lead	boolean	Optional	1 = Fetch actual leads, 0 = Fetch view (non-lead) inquiries.	1
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
agent_details	object	Optional
listing_details	object	Optional
inquirer_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=email&target=listing&is_lead=1&agency_ids[]=&created_from=2025-10-01&created_to=2025-10-08&page=1&per_page=50' \
--header 'Authorization: Bearer <token>'

{
    "data": [
        {
            "lead": {
                "id": "email|6115aeac-se-9fbf-2cf58a947176",
                "source": "bayut",
                "target": "listing",
                "channel": "email",
                "date_time": "2025-07-25 16:08:09"
            },
            "agent_details": {
                "url": "https://www.bayut.com/brokers/test-2065503.html",
                "name": "Jane doe",
                "email": "jane@example.com",
                "phone": "+97111111111",
                "proxy_number": "+9713333333"
            },
            "listing_details": {
                "id": 12201816,
                "reference": "B-Jul-Eleven-VR-125384",
                "category": "Townhouse"
            },
            "inquirer_details": {
                "name": "John Doe",
                "cell": "+9715444444444",
                "email": "john@example.com",
                "message": "I would like to inquire about your property Bayut - B-Jul-Eleven-VR-12384. Please contact me at your earliest convenience."
            }
        }
    ],
    "meta": {
        "current_page": 21,
        "from": 1,
        "to": 1,
        "per_page": 1,
        "total": 34
    }
}