v1

latestOpenAPI 3.1.02026-08-04526150.1 KB
Sales

Search for Sales Properties

This endpoint returns all active sales properties in your Street account.

By default it will only return 'active' properties i.e. those with a status of For Sale, For Sale and To Let, Under Offer or Sold STC.

It will also return properties for ALL branches within your Street account, if you wish to limit to a specific branch you can use the filter[branch] query param and pass the UUID of the desired branch.

get/sales/search

Query parameters

filter[areas]string

Areas are entered by the agent in the Street UI and enable you to filter properties according to custom areas. This can be used to power user friendly searches using familiar geographic areas.

These areas should be passed to the API in lowercase and urlencoded.

You can also enter a comma seperated list to return all properties within any of those areas.

filter[bedrooms]string

The exact number of bedrooms for search results.

filter[min_bedrooms]string

Minimum number of bedrooms for search results.

filter[branch]string

Filter by network branch. Provide the UUID of a branch to filter properties by a specific branch.

filter[features]string

Features are entered by the agent as part of the Property description - these could be things such as "Garden" or "Off Road Parking".

These features should be passed to the API in lowercase and urlencoded.

You can also enter a semi-colon seperated list to return all properties with any of those features.

filter[include_land]string

Filter by property type. Defaults to false. By setting this to true, the feed will also include land-only properties.

filter[max_price]string

Maximum listing price for search results.

filter[min_price]string

Minimum listing price for search results.

filter[postcode]string

This filter will narrow your search results by first or partial postcode.

A value of M will return all properties who's postcode begins with M, including M1 1JU & M28 2PD.

Entering in M28 2 will return all active properties in that postcode sector.

filter[status]string[]

Filter by property status. You can use a comma separated list for multiple statuses.

filter[tags]string

Tags are entered by the agent in the Street UI and enable you to filter properties according to custom criteria. This can be used to power featured properties, carousels, hot property lists etc.These tags should be passed to the API in lowercase and urlencoded.You can also enter a comma seperated list to return all properties with any of those tags.

includestring[]

Optional related entities to include in the results.

page[number]number
Example:3

Set the page number.

page[size]number
Example:25

Set the number of results per page.

sort'price' | '-price' | 'created_at' | '-created_at'

A field by which to sort. Prefixing with a minus symbol denotes a DESC order.

filter[include_archived]string

Include archived properties within the result set

Response

The API endpoint responds with a JSON object containing a list of sales properties matching the specified criteria. Each property object within the response typically includes information such as property ID, address, description, price, number of bedrooms, and other relevant details. The response also includes pagination metadata, such as the total number of properties, the current page number, and the number of properties per page.