# Mudah.my Property Building API Documentation

<p><strong>Mudah.my Property Building API</strong> returns one building by its UUID with latitude and longitude, address, developer, facilities, photos, description, price ranges, listing counts and nearby amenities.</p>

- **Documentation:** [https://scrappa.co/docs/mudah-property-api/mudah_property_building](https://scrappa.co/docs/mudah-property-api/mudah_property_building)
- **API group:** Mudah.my Property API
- **Endpoint:** `GET https://scrappa.co/api/mudah-property/v1/building`

## 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 |
| --- | --- | --- | --- |
| `prop_id` | string | Yes | Building UUID from the buildings or autocomplete endpoint. Example: 00474b41-2675-4e89-81ce-442d0961060c. |

## Example response

```json
{
    "data": {
        "name": "Habitus @ City Of Elmina",
        "size": null,
        "slug": "habitus-city-of-elmina",
        "about": "Habitus @ City Of Elmina is located in Persiaran Metafasa, Shah Alam, in Selangor.\n\nNearby, residents can enjoy amenities like Park At Astellia Residences, Shah Alam, Park At Residential Park, Taman Bukit Subang, Park At Taman Ferrea Denai Alam.\n\nPublic tra...",
        "units": null,
        "floors": null,
        "images": [
            "https://cdn.rnudah.com/image_property/plain/8dcdbc744275dd4ece85cb708037913e-2845783011205945131.jpg"
        ],
        "tenure": "Freehold",
        "address": "Persiaran Metafasa",
        "prop_id": "00474b41-2675-4e89-81ce-442d0961060c",
        "summary": [
            {
                "label": "Sale Price",
                "value": "RM 240 000 - RM 550 000"
            },
            {
                "label": "Rental Price",
                "value": "RM 1 100 - RM 3 000"
            }
        ],
        "bedrooms": null,
        "latitude": 3.0739429,
        "location": {
            "label": null,
            "region": "Selangor",
            "subarea": "Shah Alam",
            "region_id": 8,
            "subarea_id": 333
        },
        "bathrooms": null,
        "developer": null,
        "longitude": 101.5185278,
        "facilities": null,
        "cover_image": "https://cdn.rnudah.com/image_property/plain/8dcdbc744275dd4ece85cb708037913e-2845783011205945131.jpg",
        "property_type": {
            "id": 5,
            "name": "Service Residence"
        },
        "completion_year": null,
        "nearby_amenities": [
            {
                "name": "Park at Taman Ferrea Denai Alam",
                "type": "Park"
            },
            {
                "name": "Park at Residential Park, Taman Bukit Subang",
                "type": "Park"
            }
        ],
        "rent_price_range": "RM 1 100 - RM 3 000",
        "sale_price_range": "RM 240 000 - RM 550 000",
        "rent_listing_count": 21,
        "sale_listing_count": 5
    },
    "meta": {
        "billable": true,
        "endpoint_family": "building"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | The requested resource does not exist or was removed. This response is not billable. |
| 503 | Upstream Unavailable | Mudah.my could not be reached. This response is not billable and is retryable. |
| 503 | Unexpected Upstream Data | Mudah.my returned data in an unexpected shape. This response is not billable and is retryable. |

## 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)