Skip to main content
GET
List properties

Overview

The properties endpoint returns all public, live property records from the Ask Wire database. Results include both listings and foreclosures by default. Use polymorphic_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). 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:
Radius search around a coordinate:
Only comparable, non-outlier properties with 3 bedrooms:

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1

Page number within the paginated result set.

page_size
integer
default:100

Number of results per page (max 300).

Required range: x <= 300
polymorphic_type
enum<string>

Restrict results to a single property type.

Available options:
listing,
foreclosure
listing_type
enum<string>

Filter by listing type.

Available options:
rent,
sale,
sold
listing_types
enum<string>[]

Filter by multiple listing types. Comma-separated.

Available options:
rent,
sale,
sold
ids
integer[]

Filter by specific property IDs. Multiple values may be separated by commas.

reference_id
string
price_min
number
price_max
number
price
number

Exact price match.

price_per_sqm
number
bedrooms_min
integer
bedrooms_max
integer
number_of_bedrooms
integer

Exact number of bedrooms.

number_of_bathrooms
integer
property_type
string[]

Comma-separated property types.

build_area
number

Exact build area in sqm.

build_area_min
number
build_area_max
number
land_area
number

Exact land area in sqm.

land_area_min
number
land_area_max
number
covered_veranda_area
number<float>
uncovered_veranda_area
number<float>
floor_number
integer
building_floor_count
integer
construction_year
integer

Exact construction year.

construction_year_min
integer
construction_year_max
integer
renovation_year
integer
renovated
boolean
energy_class
enum<string>
Available options:
A,
B,
C,
D,
E,
F,
G,
Exempt,
Under issuance
heating_type
string
view
string
garage
boolean
garden
boolean
swimming_pool
boolean
municipality
integer[]

Comma-separated municipality IDs.

municipal_unit
integer[]

Comma-separated municipal unit IDs.

region
integer[]

Comma-separated region IDs.

regional_unit
integer[]

Comma-separated regional unit IDs.

neighborhood
integer[]

Comma-separated neighborhood IDs.

country
string
address
string
lat
number

Latitude of center point. Use with lng and radius_km.

lng
number

Longitude of center point. Use with lat and radius_km.

radius_km
number

Search radius in kilometers. Use with lat and lng.

latitude
number
latitude_min
number
latitude_max
number
longitude
number
longitude_min
number
longitude_max
number
polygon
string

Comma-separated lng lat pairs forming a closed polygon.

wkt
string

WKT geometry string (e.g. POLYGON((lng lat, ...))).

seller
integer
source
string
source_type
string
source_types
string[]

Comma-separated source types.

tags
integer[]

Comma-separated tag IDs.

comparable
boolean
outlier
boolean
is_live
boolean
is_public
boolean
is_modified
boolean
is_manually_updated
boolean
is_ai_updated
boolean
is_ai_processed
boolean
is_ai_mismatched
boolean
is_duplicated
boolean
is_master_property
boolean
is_deduplication_processed
boolean
is_leader
boolean
master_property_id
integer
polymorphic_ctype
integer
created_at
string<date-time>
modified_at
string<date-time>
first_seen_at
string<date-time>
last_seen_at
string<date-time>
delisted_at
string<date-time>
description
string
url
string

Response

Paginated property results

count
integer
next
string<uri> | null
previous
string<uri> | null
results
object[]