Skip to main content
GET
/
v1
/
property
/
{locationIds}
Get properties by location IDs
curl --request GET \
  --url https://api.vepler.com/v1/v1/property/{locationIds} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "result": [
    {
      "propertyId": "prop_123abc",
      "locationId": "loc_456def",
      "classificationCode": "RD06",
      "propertyType": "terraced",
      "propertySubType": "Victorian terrace",
      "address": {
        "displayAddress": "123 Example Street, London SW1A 1AA",
        "streetName": "Example Street",
        "streetNumber": "123",
        "locality": "Westminster",
        "town": "London",
        "county": "Greater London",
        "postcode": "SW1A 1AA",
        "postcodeNoSpace": "SW1A1AA",
        "outcode": "SW1A",
        "incode": "1AA",
        "country": "GB"
      },
      "spatial": {
        "lat": 51.5074,
        "lng": -0.1278,
        "boundary": "<any>"
      },
      "roomDetails": {
        "beds": 3,
        "baths": 2,
        "receptions": 1
      },
      "pricing": {
        "currentSalePrice": 50000000,
        "currentRentPrice": 250000,
        "estimatedSaleValue": 52000000,
        "estimatedRentValue": 260000,
        "pricePerSqFt": 850,
        "currency": "GBP"
      },
      "marketStatus": {
        "forSale": "live",
        "forRent": "unavailable",
        "listingDate": "2024-01-15T00:00:00Z",
        "soldDate": "2024-03-20T00:00:00Z",
        "daysOnMarket": 65
      },
      "epc": {
        "currentEnergyRating": "C",
        "potentialEnergyRating": "B",
        "currentEnergyEfficiency": 69,
        "potentialEnergyEfficiency": 83,
        "validFrom": "2023-06-15",
        "validTo": "2033-06-14"
      },
      "saleHistory": [
        {
          "date": "2023-06-15",
          "price": 45000000,
          "propertyType": "terraced",
          "newBuild": false
        }
      ],
      "tenure": {
        "type": "freehold",
        "leaseYearsRemaining": 95,
        "groundRent": 25000,
        "serviceCharge": 180000
      },
      "councilTax": {
        "taxBand": "D",
        "annualCharge": 180000,
        "localAuthority": "Westminster City Council"
      },
      "tags": {
        "newBuild": false,
        "chainFree": true,
        "auction": false,
        "sharedOwnership": false,
        "retirement": false,
        "cashBuyersOnly": false,
        "investment": false
      },
      "floorAreaSqM": 85,
      "plotSizeSqM": 120,
      "yearBuilt": 1890,
      "lastUpdated": "2024-01-15T10:30:00Z"
    }
  ],
  "totalSize": 150,
  "size": 25,
  "hasMore": true,
  "nextOffset": 25
}

Authorizations

x-api-key
string
header
required

API Key authentication for Vepler API. Get your API key from the Vepler dashboard.

Path Parameters

locationIds
string
required

Comma-separated list of location IDs

Query Parameters

limit
string

Maximum number of results to return

offset
string

Number of results to skip

attributes
string

Comma-separated list of attributes to include

Response

Property data successfully retrieved

success
boolean
required
result
object[]
required

Array of property data objects

totalSize
number
required

Total number of properties matching the query

Example:

150

size
number
required

Number of properties returned in this response

Example:

25

hasMore
boolean

Indicates if more results are available

Example:

true

nextOffset
number

Offset to use for next page of results

Example:

25