List properties
Returns a paginated list of public, live properties — listings and foreclosures.
Overview
The properties endpoint returns all public, live property records from the Ask Wire database. Results include both listings and foreclosures by default. Usepolymorphic_type to restrict to one type.
All responses are paginated. The default page size is 100, with a maximum of 300.
Query parameters
Pagination
Property type
Identifiers
Price
Size & area
Rooms & layout
Building details
Geographic filters
Administrative boundaries
Use these to filter by region in the Ask Wire geographic hierarchy (region → regional unit → municipality → municipal unit → neighborhood).Radius search
Search properties within a circular area. All three parameters are required together.Bounding box
Filter by exact coordinate ranges.Polygon / WKT
For complex shape queries, pass a geometry directly.Source
Status & data quality flags
These boolean flags let you filter based on the property’s processing state and data quality.Tags
Dates
All date filters accept ISO 8601 datetime strings (e.g.2025-01-01).
Example requests
List sale apartments in Athens:Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Page number within the paginated result set.
Number of results per page (max 300).
x <= 300Restrict results to a single property type.
listing, foreclosure Filter by listing type.
rent, sale, sold Filter by multiple listing types. Comma-separated.
rent, sale, sold Filter by specific property IDs. Multiple values may be separated by commas.
Exact price match.
Exact number of bedrooms.
Comma-separated property types.
Exact build area in sqm.
Exact land area in sqm.
Exact construction year.
A, B, C, D, E, F, G, Exempt, Under issuance Comma-separated municipality IDs.
Comma-separated municipal unit IDs.
Comma-separated region IDs.
Comma-separated regional unit IDs.
Comma-separated neighborhood IDs.
Latitude of center point. Use with lng and radius_km.
Longitude of center point. Use with lat and radius_km.
Search radius in kilometers. Use with lat and lng.
Comma-separated lng lat pairs forming a closed polygon.
WKT geometry string (e.g. POLYGON((lng lat, ...))).
Comma-separated source types.
Comma-separated tag IDs.
