Immovlan Agency Listings API List the properties of one agency for sale, for rent and in public sale. It takes the same filters, sort and page as the search endpoint and returns the same listing rows. The transaction is optional here.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
25 optional filters available.
integer
Required
Agency id from a search result (agency.id).
1234567890
string
Optional
for-sale, for-rent or in-public-sale (default all).
example
string
Optional
One or more, comma separated: house, apartment, land, garage, student-housing, business, investment-property, miscellaneous.
example
string
Optional
One or more, comma separated, e.g. residence, villa, bungalow, penthouse, duplex, studio, loft, ground-floor, development-site.
example
string
Optional
Municipality slugs from the autocomplete endpoint (type municipality), comma separated, e.g. antwerp.
example
string
Optional
Town slugs from the autocomplete endpoint (type town), comma separated, e.g. 2018-antwerp.
example
string
Optional
Province slugs from the autocomplete endpoint, comma separated, e.g. antwerp.
example
string
Optional
Region slugs from the autocomplete endpoint, comma separated, e.g. brussels-region.
US
integer
Optional
Minimum price in EUR (monthly rent for for-rent).
10
integer
Optional
Maximum price in EUR (monthly rent for for-rent).
10
integer
Optional
Minimum bedrooms.
10
integer
Optional
Maximum bedrooms.
10
integer
Optional
Minimum bathrooms.
10
integer
Optional
Maximum bathrooms.
10
integer
Optional
Minimum living area in m2.
10
integer
Optional
Maximum living area in m2.
10
integer
Optional
Minimum total (plot) area in m2.
10
integer
Optional
Maximum total (plot) area in m2.
10
string
Optional
One or more, comma separated: excellent, good, poor, bad, unknown.
example
string
Optional
One or more, comma separated: new, normal, excellent, to-be-renovated, fully-renovated.
example
string
Optional
One or more, comma separated: 2, 3, 4.
example
string
Optional
Features that must all be present, comma separated, e.g. hasswimmingpool, hasgarden, hasterrace, hasgarage, isfurnished.
example
string
Optional
privateuser or prouser.
example
string
Optional
price, bedrooms, area (total area) or zip. Without it the Immovlan order is used.
relevance
string
Optional
asc or desc (default asc, only with sort).
example
integer
Optional
Page number, 1 to 50 (default 1). 20 listings per page, so results stop at 1000.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"size": 20,
"count": 17,
"has_more": false,
"listings": [
{
"id": "RBX23261",
"url": "https://immovlan.be/en/detail/apartment/for-sale/2170/merksem/rbx23261",
"tags": [
"HasUpsellColor",
"HasPicture",
"HasEpcCertificate",
"IsBestOf",
"IsNew",
"HasGarden"
],
"image": "https://api-image.immovlan.be/v1/property/RBX23261/thumbnail-webp/Medium?h=280",
"price": 250000,
"title": "Apartment for sale",
"agency": {
"id": 48956,
"logo": "https://api-image.immovlan.be/v1/prouser/HS355965060308/logo/English/webp/Small",
"name": "Onid Real Estate - Merksem",
"type": "estateAgents",
"phone": "+32 3 289 11 00"
},
"status": "published",
"address": {
"zip": "2170",
"city": "Merksem",
"text": "2170 Merksem",
"country": "Belgium"
},
"has_epc": true,
"bedrooms": 1,
"currency": "EUR",
"price_to": null,
"bathrooms": 1,
"proximity": [
{
"name": "Bus",
"by_car": false,
"minutes": 4,
"category": "transports"
},
{
"name": "School",
"by_car": false,
"minutes": 5,
"category": "education"
},
{
"name": "Shop",
"by_car": false,
"minutes": 4,
"category": "shop"
}
],
"highlights": [
{
"key": "NrOfBedrooms",
"label": "Bedroom(s)",
"value": "1"
},
{
"key": "LivableSurface",
"label": "m\u00b2",
"value": "95"
},
{
"key": "NrOfBathrooms",
"label": "Bathroom(s)",
"value": "1"
}
],
"is_project": false,
"price_from": null,
"year_built": 1967,
"description": "For sale in Merksem, this ground-floor property combines a commercial space with a one-bedroom apartment, garden and garage box. Offered at **250 000 \u20ac**, it presents an opportunity to bring residential and commercial...",
"living_area": 95,
"property_id": 10802709,
"transaction": "sale",
"published_at": "2026-10-23T19:01:46.000000+00:00",
"display_price": "250 000 \u20ac",
"property_type": "appartment",
"agency_reference": "4493497",
"property_subtype": "flat",
"living_area_range": null,
"recently_modified": true,
"price_recently_modified": false
}
],
"total_count": 17,
"total_pages": 1,
"transaction": null,
"filters_applied": {
"agency_id": 48956
},
"reachable_count": 17
},
"meta": {
"billable": true,
"endpoint_family": "search",
"duplicates_removed": 0,
"rows_removed_by_guard": 0
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter is missing or invalid. This response is not billable.
{
"errors": {
"agency_id": [
"An agency_id is required. Take it from a search result (agency.id)."
]
},
"message": "The request validation failed"
}Service Unavailable
Immovlan could not be reached or returned an unreadable page after retries. Retry shortly. This response is not billable.
{
"meta": {
"attempts": 3,
"billable": false,
"retryable": true
},
"error": {
"message": "Immovlan data is temporarily unavailable. Please retry.",
"failure_type": "upstream_unavailable"
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.