← Home Project — Enhanced WhatsApp Leads

Get Enhanced Whatsapp Leads

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

Retrieves leads received through whatsapp related to projects.The is_lead parameter determines whether to fetch actual leads or views 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).	whatsapp
target	string	Optional	Lead target type (e.g., listing).	project
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
agency_details	object	Optional
inquirer_details	object	Optional
project_details	object	Optional
delivery_notifications	array[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=whatsapp&target=project&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": "whatsapp|7c2c8cc0-1bd5-44ff-8574-8414bfd88df0",
                "source": "bayut",
                "target": "project",
                "channel": "whatsapp",
                "date_time": "2025-09-22 10:07:34"
            },
            "agency_details": {
                "url": "https://www.bayut.com/companies/test-development-1111",
                "name": "Test Development"
            },
            "inquirer_details": {
                "name": "Jane",
                "cell": "+9733333333",
                "email": "",
                "message": "Hi! I’m interested in the below Project.\n\nProject name: Waref Residences by Sido\nLink: https://www.bayut.com/for-sale/off-plan/property/dubai/jumeirah-village-circle-jvc/jvc-district-11/waref-residences-by-sido/\n\n*Kindly do not edit this message to ensure your inquiry is received."
            },
            "project_details": {
                "date": "-",
                "name": "Sweet Residences by Test",
                "location": "-"
            },
            "delivery_notifications": [
                {
                    "status": "sent",
                    "created_at": "2025-09-22 10:07:40"
                },
                {
                    "status": "delivered",
                    "created_at": "2025-09-22 10:07:40"
                },
                {
                    "status": "read",
                    "created_at": "2025-09-22 10:07:44"
                }
            ]
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "to": 1,
        "per_page": 50,
        "total": 2
    }
}