# OpenRent Property API Documentation

<p><strong>OpenRent Property API</strong> returns one rental listing: title, description, rent, deposit, bills, tenant preferences (students, families, pets, smokers, DSS), availability, minimum tenancy, online viewings, features, furnishing, EPC rating, coordinates, all photos, local transport, nearby schools and a landlord summary with response rate and response time. Street address and floor area are not published by OpenRent and are returned as null.</p>

- **Documentation:** [https://scrappa.co/docs/openrent-api/openrent_property](https://scrappa.co/docs/openrent-api/openrent_property)
- **API group:** OpenRent API
- **Endpoint:** `GET https://scrappa.co/api/openrent/property`

## 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` | integer | Yes | Property id from the search endpoint, e.g. 2940468. |

## Example response

```json
{
    "data": {
        "listing": {
            "id": 2940468,
            "url": "https://www.openrent.co.uk/property-to-rent/london/1-bed-flat-charring-cross-prime-location-wc2n/2940468",
            "city": "London",
            "title": "1 Bed Flat, Charring Cross Prime Location, WC2N",
            "images": [
                "https://imagescdn.openrent.co.uk/listings/2940468/o_1jri9p7u21r4uq8r1kom6uo4a58.JPG",
                "https://imagescdn.openrent.co.uk/listings/2940468/o_1jri9p9d51du81qo10cjkpl47gb.JPG",
                "https://imagescdn.openrent.co.uk/listings/2940468/o_1jri9p9tdq4una7clrm75jmrc.JPG"
            ],
            "address": null,
            "deposit": 669.23,
            "outcode": "WC2N",
            "schools": [
                {
                    "name": "The Royal Ballet School",
                    "levels": [
                        "Secondary",
                        "Post-16"
                    ],
                    "distance_km": 0.7,
                    "walk_minutes": 10
                },
                {
                    "name": "St Clement Danes CofE Primary School",
                    "levels": [
                        "Nursery",
                        "Primary"
                    ],
                    "distance_km": 0.8,
                    "walk_minutes": 12
                }
            ],
            "area_sqm": null,
            "bedrooms": 1,
            "currency": "GBP",
            "landlord": {
                "id": 7829841,
                "url": "https://www.openrent.co.uk/search/searchbylandlord?landlordID=7829841",
                "name": "Realty L.",
                "avatar_url": "https://imagescdn.openrent.co.uk/userPhotos/7829841/71a4e44b49.JPG_t.JPG",
                "member_since": "March 2025",
                "response_rate": 99,
                "response_time": "Within 2 Days",
                "email_verified": true,
                "phone_verified": false
            },
            "latitude": 51.50738,
            "location": "London, WC2N",
            "bathrooms": 1,
            "longitude": -0.1244289,
            "transport": [
                {
                    "mode": "Underground",
                    "name": "Charing Cross",
                    "walk_minutes": 2
                },
                {
                    "mode": "National Rail",
                    "name": "London Charing Cross",
                    "walk_minutes": 2
                },
                {
                    "mode": "Underground",
                    "name": "Embankment",
                    "walk_minutes": 4
                },
                {
                    "mode": "Underground",
                    "name": "Leicester Square",
                    "walk_minutes": 10
                }
            ],
            "epc_rating": "C",
            "furnishing": "Furnished",
            "has_garden": false,
            "description": "All Bills Included \u2013 Spacious 1-Bed Flat in Central London!\nLooking for a comfortable home in the heart of London? This bright and spacious 1-bedroom flat offers the perfect mix of space, convenience, and character.\nSet within a charming co\u2026",
            "has_parking": false,
            "max_tenants": 1,
            "dss_accepted": false,
            "pets_allowed": false,
            "has_fireplace": false,
            "available_from": "2027-01-05",
            "bills_included": true,
            "rent_per_month": 2850,
            "online_viewings": true,
            "smokers_allowed": true,
            "families_allowed": false,
            "students_allowed": true,
            "minimum_tenancy_months": 6
        }
    },
    "meta": {
        "billable": true,
        "duration_ms": 1210,
        "endpoint_family": "property"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | OpenRent has no such location, property or landlord. This response is not billable. |
| 503 | Service Unavailable | OpenRent is temporarily unavailable. This response is not billable and can be retried. |

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