← Home Project — Off Plan CPL Leads

Get Off Plan CPL Leads

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

Retrieves a paginated list of Off Plan Campaign leads based on specified filters like channel, target, type, agency IDs, and date range. Each lead includes basic lead information, inquirer details, and project 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., project).	project
type	string	Optional	Type of lead (e.g., offplan).	offplan
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
inquirer_details	object	Optional
project_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=project&type=offplan&agency_ids[]=&created_from=2025-10-01&created_to=2025-10-08&page=1&per_page=50' \
--header 'Authorization: Bearer <token>'

{
    "data": [
        {
            "lead": {
                "id": "8b791a52-1b69-412a-97ce-345ad28b90db",
                "source": "bayut",
                "target": "project",
                "channel": "website",
                "date_time": "2025-10-07 12:54:56"
            },
            "inquirer_details": {
                "name": "Inquirer",
                "cell": "447889202983",
                "email": null,
                "message": null
            },
            "project_details": {
                "date": "2025-10-08",
                "name": "Neva Residences",
                "location": "JVC District 16, Jumeirah Village Circle (JVC), Dubai"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "to": 1,
        "per_page": 1,
        "total": 54
    }
}