# Immovlan Listing Details API Documentation

<p><strong>Immovlan Listing Details API</strong> Get a full listing: price, address with latitude and longitude, bedrooms, bathrooms, living area, year built, energy certificate, all detail sections (financial, interior, outdoor, certificates, flood risk), amenities, the description, up to 32 images and the agency.</p><p>Use the <code>id</code> from the search endpoint, or paste the listing url. New-build projects (ids like 22363-1726499) return partial data with <code>is_project</code>: true, a price range and no coordinates.</p>

- **Documentation:** [https://scrappa.co/docs/immovlan-api/immovlan_listing](https://scrappa.co/docs/immovlan-api/immovlan_listing)
- **API group:** Immovlan API
- **Endpoint:** `GET https://scrappa.co/api/immovlan/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Listing id (id) from the search endpoint, e.g. RBW88958, a project id, or the listing url. |

## Example response

```json
{
    "data": {
        "id": "RBW88958",
        "epc": {
            "grade": "A",
            "reference": "12041-G-OMV_2021128553/EP18083/A001/D01/SD001",
            "valid_until": "28/11/2034",
            "consumption_kwh_m2_year": 29
        },
        "url": "https://immovlan.be/en/detail/residence/for-sale/2870/puurs/rbw88958",
        "price": 799000,
        "state": "Normal",
        "title": "Residence for sale, Puurs",
        "agency": {
            "id": 43022,
            "logo": "https://api-image.immovlan.be/v1/prouser/RMG01376231/logo/English/webp/Small",
            "name": "Vmv-vastgoed"
        },
        "images": [
            "https://api-image.immovlan.be/v1/property/RBW88958/images/5166f5e101fa43d6900a69da59bfefd8.jpg/Large",
            "https://api-image.immovlan.be/v1/property/RBW88958/images/b76e190e5528448a9f17ec474f733422.jpg/Large",
            "https://api-image.immovlan.be/v1/property/RBW88958/images/f51e7f42c0d946b085eb86e7c2ad05e1.jpg/Large"
        ],
        "address": {
            "zip": "2870",
            "city": "Puurs",
            "text": "Rijweg 1, 2870 Puurs",
            "street": "Rijweg 1"
        },
        "facades": 3,
        "bedrooms": 4,
        "currency": "EUR",
        "latitude": 51.05806,
        "price_to": null,
        "sections": [
            {
                "title": "General info",
                "details": [
                    {
                        "label": "State of the property",
                        "value": "Normal"
                    },
                    {
                        "label": "Currently leased",
                        "value": "No"
                    },
                    {
                        "label": "Build Year",
                        "value": "2023"
                    },
                    {
                        "label": "Availability",
                        "value": "Negotiable"
                    }
                ]
            },
            {
                "title": "Financial details",
                "details": [
                    {
                        "label": "Price",
                        "value": "799 000 \u20ac"
                    },
                    {
                        "label": "Cadastral income",
                        "value": "1 367 \u20ac"
                    },
                    {
                        "label": "VAT",
                        "value": "No"
                    }
                ]
            },
            {
                "title": "Interior description",
                "details": [
                    {
                        "label": "Number of bedrooms",
                        "value": "4"
                    },
                    {
                        "label": "Livable surface",
                        "value": "332 m\u00b2"
                    },
                    {
                        "label": "Furnished",
                        "value": "No"
                    }
                ]
            }
        ],
        "amenities": [
            {
                "name": "Garden",
                "value": true
            },
            {
                "name": "Terrace",
                "value": true
            }
        ],
        "bathrooms": 2,
        "longitude": 4.33604,
        "highlights": [
            {
                "label": "Bedroom(s)",
                "value": "4"
            },
            {
                "label": "m\u00b2",
                "value": "332"
            },
            {
                "label": "Bathroom(s)",
                "value": "2"
            },
            {
                "label": "Terrace",
                "value": null
            },
            {
                "label": "Garden",
                "value": null
            }
        ],
        "is_project": false,
        "price_from": null,
        "year_built": 2023,
        "description": "This exceptional semi-detached residence for sale in Puurs offers a modern and spacious living environment, completed in 2023 on a generous 579 m\u00b2 plot. Priced at 799,000 \u20ac, the property boasts a substantial usable fl...",
        "living_area": 332,
        "availability": "Negotiable",
        "published_at": "2026-09-11T19:51:17.6784340",
        "display_price": "799 000 \u20ac"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The listing was not found. It may be sold or withdrawn. This response is not billable. |
| 503 | Service Unavailable | Immovlan could not be reached or returned an unreadable page after retries. Retry shortly. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)