Property

Get Property

GET

Retrieve all the details of a property given its id.

  • ID changes: it is rare, but can happen, to see the id of a property change. We consider it unlikely for bigger properties since they tend to have a more established “identity” among our data pipelines. For example, if multiples properties are merged into one, or major data changes make us change the id. In this case, you might receive a 404 error. The property search endpoint is free, so always feel free to query it in case that happens.
  • Payload usage: this payload can be used to get the property details, the unit pricing, the expense benchmarks, and the rent comps. And you are free to cache it if you need to.

We make a few properties free to access to help with testing. These three properties are listed below but if you would like to use a different property to test with, we are happy to allow that for you.

IDBuilding NameAddress
e8769b06-1334-5ab6-b9c6-6dfccbf9ea78Reserve at Glenview195 Waukegan Road, Glenview, IL 60025
20e4945a-ce78-5f2c-9053-6bdaca39044b7229-33 S Yates Blvd7229 South Yates Boulevard, Chicago, IL 60649
0e628031-57b8-5394-821d-13779318fef4OneEleven111 West Wacker Drive, Chicago, IL 60601

Path parameters

idstringRequired
The property id (UUIDv5 retrieved from the search endpoint).

Response

This endpoint returns an object
id
string
The unique identifier of the property. It is a stringified UUIDv5. This value can occasionally change if multiple properties get merged into one.
street_address
string
The primary street address of the property.
street_address_alias
list of strings
Alternate or commonly used names or aliases for the street address.
city
string
The city where the property is located.
state
string
The state where the property is located.
zip_code
string
The postal code for the property's location.
lat
double
Latitude coordinate of the property's location.
lon
double
Longitude coordinate of the property's location.
building_name_alias
list of strings
Alternative names or aliases for the building.
specials_history
list of objects
Historical special offers or promotions available at the property, along with extracted values from the text.
pricing_strategy
object
Analysis of the property's pricing patterns and strategies.
created_on
string
Date when the property details were last updated or created.
building_quality
object
The quality scores for various aspects of the property, including both general areas and specific features.
building_availability
list of objects
The list of units and floorplans available at the property.
msa
stringOptional
Metropolitan Statistical Area the property belongs to, if applicable.
market_embedding
list of doublesOptional
An array representing the market embedding vector, used for advanced analyses. If you want to compare two markets, you can use the cosine similarity between their market embeddings. Note: this vector is subject to change a couple of times a year as we improve our models.
demographics
map from strings to optional doublesOptional

Beta Subject to change in near future. The demographics for the property’s location, if available.

census_tract_id
stringOptional
The FIPS code of the property's location.
building_name
stringOptional
The name of the building or property.
building_phone_number
stringOptional
Contact phone number for the building management or leasing office.
building_website
stringOptional
Website URL for the property or management company.
is_single_family
booleanOptional
Indicates if the property is a single-family home.
is_condo
booleanOptional
Indicates if the property consists of condominiums.
is_apartment
booleanOptional
Indicates if the property is an apartment complex.
number_units
doubleOptional
Total number of units in the property.
number_units_prediction
doubleOptional
A prediction of the number of units based on images, number of floors, amenities, location, year built, and the number of units we have seen so far. NOTE: This is an approximation to understand the property's size when the exact number of units is not available, do not use it as a variable in your financial models.
year_built
doubleOptional
Year the property was originally built.
year_built_prediction
stringOptional
Predicted or estimated construction period or era based on listing images.
number_stories
doubleOptional
Number of stories or levels in the property.
number_stories_prediction
stringOptional
Predicted or estimated range for the number of stories in the building based on facade images.
management_company
stringOptional
Name of the company managing the property.
concessions_history
list of objectsOptional
Historical concession offers or promotions available at the property, along with extracted values from the text.
cats_monthly_rent
doubleOptional
Monthly rent charge for having cats.
cats_one_time_fee
doubleOptional
One-time fee for having cats.
cats_deposit
doubleOptional
Deposit required for having cats.
dogs_monthly_rent
doubleOptional
Monthly rent charge for having dogs.
dogs_one_time_fee
doubleOptional
One-time fee for having dogs.
dogs_deposit
doubleOptional
Deposit required for having dogs.
admin_fee
doubleOptional
Administrative fee charged by the property.
amenity_fee
doubleOptional
Amenity fee charged by the property, if applicable.
application_fee
doubleOptional
Application fee charged to apply for residency.
storage_fee
doubleOptional
Fee for using storage facilities on the property.
parking_covered
doubleOptional
Monthly charge for covered parking, if available.
parking_garage
doubleOptional
Monthly charge for parking in a garage, if available.
parking_surface_lot
doubleOptional
Monthly charge for parking in a surface lot, if available.
lease_lengths
stringOptional
Available lease lengths in months.
min_deposit
doubleOptional
Minimum security deposit required.
max_deposit
doubleOptional
Maximum security deposit required (may vary by unit).
building_amenities
list of enumsOptional
List of amenities available in the building.
unit_amenities
list of enumsOptional
List of amenities available in the units.
estimated_occupancy
doubleOptional
Advertised occupancy rate of the property.
price_history
list of objectsOptional
Precomputed prices per unit type for the property over time. Deprecated, use the prices in the Availability object instead for more flexibility.
specials
stringOptional

Current special offers or promotions available at the property. Deprecated, use the concessions_history field instead to get all concessions over time.

GET
1curl https://api.hellodata.ai/property/52907745-7672-470e-a803-a2f8feb52944 \
2 -H "x-api-key: <apiKey>"
200Retrieved
1{
2 "id": "52907745-7672-470e-a803-a2f8feb52944",
3 "street_address": "111 West Wacker Drive",
4 "street_address_alias": [
5 "111 West Wacker",
6 "111 West Wacker Drive"
7 ],
8 "city": "Chicago",
9 "state": "IL",
10 "zip_code": "60601",
11 "lat": 41.88651,
12 "lon": -87.63141,
13 "building_name_alias": [
14 "building_name_alias"
15 ],
16 "specials_history": [
17 {
18 "specials": "1 month free on 12 month lease if you move in by 12/31/2021",
19 "from_date": "2021-01-01",
20 "to_date": "2021-01-01",
21 "condition_lease_term_months": 12,
22 "condition_deadline": "2021-01-01",
23 "free_months": 1,
24 "one_time_dollars_off": 100,
25 "recurring_dollars_off": 100,
26 "waived_application_fee": true,
27 "waived_security_deposit": true,
28 "waived_administrative_fee": true,
29 "waived_move_in_fee": true,
30 "cheaper_security_deposit": true,
31 "cheaper_administrative_fee": true,
32 "cheaper_application_fee": true,
33 "cheaper_move_in_fee": true,
34 "cheaper_rent": true
35 }
36 ],
37 "pricing_strategy": {
38 "is_using_rev_management": true,
39 "avg_duration": 30,
40 "avg_price_change": 100,
41 "avg_time_on_market": 30,
42 "day_of_week_distribution": [
43 27,
44 18,
45 12,
46 12,
47 30,
48 3,
49 10
50 ],
51 "count_prices": 100
52 },
53 "created_on": "2021-01-01",
54 "building_quality": {
55 "property_overall_quality": 0.85,
56 "avg_quality_score_bedroom": 0.82,
57 "avg_quality_score_kitchen": 0.87,
58 "avg_quality_score_bathroom": 0.81,
59 "avg_quality_score_dining_room": 0.8,
60 "avg_quality_score_common_areas": 0.83,
61 "avg_quality_score_fitness_center": 0.78,
62 "avg_quality_score_laundry_room": 0.75,
63 "avg_quality_score_living_room": 0.84,
64 "avg_quality_score_main_entrance": 0.86,
65 "avg_quality_score_stairs_hallway": 0.79,
66 "avg_quality_score_swimming_pool": 0.88,
67 "avg_quality_score_walk_in_closet": 0.8
68 },
69 "building_availability": [
70 {
71 "id": "52907745-7672-470e-a803-a2f8feb52944",
72 "is_floorplan": true,
73 "renovated": false,
74 "furnished": true,
75 "den": false,
76 "convertible": true,
77 "created_on": "2021-01-01",
78 "history": [
79 {
80 "from_date": "2021-01-01",
81 "to_date": "2021-01-01",
82 "min_price": 1200,
83 "price": 1500,
84 "max_price": 1800,
85 "min_effective_price": 1150,
86 "effective_price": 1450,
87 "max_effective_price": 1750,
88 "period_id": 0
89 }
90 ],
91 "price_plans": [
92 {
93 "duration_in_months": 12,
94 "specials": "Special incentives available at OneEleven! Enjoy up to a half month free on select apartments.",
95 "monthly_rent": 1500
96 }
97 ],
98 "amenities": [
99 "amenities"
100 ],
101 "floorplan_name": "2B2B",
102 "unit_name": "203",
103 "floor": 5,
104 "availability": "2021-01-01",
105 "min_price": 1200,
106 "price": 1500,
107 "max_price": 1800,
108 "min_effective_price": 1150,
109 "effective_price": 1450,
110 "max_effective_price": 1750,
111 "bed": 2,
112 "bath": 2,
113 "partial_bath": 1,
114 "enter_market": "2021-01-01",
115 "exit_market": "2021-01-01",
116 "days_on_market": 45,
117 "min_sqft": 800,
118 "sqft": 850,
119 "max_sqft": 900,
120 "availability_periods": [
121 {
122 "period_id": 0,
123 "enter_market": "2021-01-01",
124 "exit_market": "2021-01-01",
125 "days_on_market": 45,
126 "availability": "2021-01-01",
127 "price_plans": [
128 {
129 "duration_in_months": 12,
130 "specials": "Special incentives available at OneEleven! Enjoy up to a half month free on select apartments.",
131 "monthly_rent": 1500
132 }
133 ]
134 }
135 ],
136 "tags": [
137 "affordable"
138 ]
139 }
140 ],
141 "msa": "Chicago-Naperville-Elgin, IL-IN-WI",
142 "market_embedding": [
143 1.1
144 ],
145 "demographics": {
146 "demographics": 1.1
147 },
148 "census_tract_id": "11001007301",
149 "building_name": "OneEleven",
150 "building_phone_number": "7087250291",
151 "building_website": "https://www.oneelevenchicago.com/",
152 "is_single_family": false,
153 "is_condo": false,
154 "is_apartment": true,
155 "number_units": 505,
156 "number_units_prediction": 460,
157 "year_built": 2014,
158 "year_built_prediction": "2020+",
159 "number_stories": 60,
160 "number_stories_prediction": "11+",
161 "management_company": "The Bozzuto Group",
162 "concessions_history": [
163 {
164 "id": "52907745-7672-470e-a803-a2f8feb52944",
165 "concessions": "1 month free on 12 month lease if you move in by 12/31/2021",
166 "from_date": "2021-01-01",
167 "to_date": "2021-01-01",
168 "items": [
169 {
170 "condition_lease_term_months": [
171 12,
172 13,
173 14
174 ],
175 "condition_bedrooms": [
176 1,
177 2,
178 3
179 ],
180 "condition_unit_names": [
181 "0115",
182 "0215"
183 ],
184 "condition_floorplans": [
185 "Floorplan 1",
186 "Floorplan 2"
187 ],
188 "condition_deadline": "2021-01-01",
189 "free_months_count": 2,
190 "free_months_until": "2021-01-01",
191 "one_time_dollars_off_amount": 500,
192 "one_time_dollars_off_percentage": 10,
193 "recurring_dollars_off_amount": 50,
194 "recurring_dollars_off_percentage": 5,
195 "waived_application_fee": true,
196 "waived_security_deposit": true,
197 "waived_administrative_fee": true,
198 "waived_move_in_fee": true,
199 "cheaper_security_deposit": true,
200 "cheaper_administrative_fee": true,
201 "cheaper_application_fee": true,
202 "cheaper_move_in_fee": true,
203 "cheaper_rent": true,
204 "condition_specific_unit": true
205 }
206 ]
207 }
208 ],
209 "cats_monthly_rent": 50,
210 "cats_one_time_fee": 50,
211 "cats_deposit": 50,
212 "dogs_monthly_rent": 50,
213 "dogs_one_time_fee": 50,
214 "dogs_deposit": 50,
215 "admin_fee": 600,
216 "amenity_fee": 1.1,
217 "application_fee": 65,
218 "storage_fee": 50,
219 "parking_covered": 300,
220 "parking_garage": 319,
221 "parking_surface_lot": 100,
222 "lease_lengths": "12,6",
223 "min_deposit": 2248,
224 "max_deposit": 2248,
225 "building_amenities": [
226 "24_hour_maintenance"
227 ],
228 "unit_amenities": [
229 "air_conditioning"
230 ],
231 "estimated_occupancy": 0.97,
232 "price_history": [
233 {
234 "history": [
235 {
236 "created_on": "2021-01-01",
237 "min_price": 1200,
238 "avg_price": 1500,
239 "max_price": 1800,
240 "min_price_psf": 1150,
241 "avg_price_psf": 1450,
242 "max_price_psf": 1750,
243 "min_effective_price": 1150,
244 "avg_effective_price": 1450,
245 "max_effective_price": 1750,
246 "min_effective_price_psf": 1150,
247 "avg_effective_price_psf": 1450,
248 "max_effective_price_psf": 1750
249 }
250 ],
251 "bed": 1.1,
252 "bath": 1.1
253 }
254 ],
255 "specials": "Special incentives available at OneEleven! Enjoy up to a half month free on select apartments."
256}