Technical Documentation
Mar 17
We've added a number of new occupant business attributes to the "tenants" detail type. These include business address components, mailing address components, secondary SIC and NAICS codes and descriptions, as well as:
ceo_full_name
(PII)ceo_title
employee_total
sales_volume
telephone_number
tradestyle_name
See the Data dictionary or the Property schema page for descriptions of the new attributes.
Jan 31
A new Property schema page provides visual schemas of our property data in a variety of layouts. Move the pointer over an attribute to view a description. You can optionally filter the views by property detail type (basic, contacts, foreclosure, etc.).
Sept 11
The new POST /property/bulk
endpoint takes up to 250 Reonomy property IDs and returns information about the specified properties. You can request as many of the available property detail types as you want (basic
, mortgages
, etc.). You can also specify whether you want to exclude personally identifiable information (PII). For more information, see Getting property details.
Aug 21
The GET /property/{property_id}
endpoint supports a new detail_type
query parameter that lets you request detail information (mortgages
, taxes
, etc.) for the specified property. If you omit the parameter, the API returns basic
property information. You can specify multiple instances of this parameter in the query string to obtain multiple detail types in a single API call, as shown in the example. For more information, see Property detail information.
Aug 17
Personally identifiable information (PII) is data that may be used to identify a particular person, and includes names, addresses, emails, etc. Some Reonomy property detail types include PII, and the Data dictionary now includes a column identifying which fields may contain PII.
PII is included by default, but if you want to exclude it from the API response, you can now do so using the filter_pii
query parameter, available on all GET /v2/property/{id}
endpoints. See Excluding personally identifiable information (PII) for more information.
The same filter is available when using the batch API to retrive bulk property data. See Preparing the job spec file for more information.
June 22
You can now view your API credit usage through the API portal. After entering your access credentials, you'll see an "API Credits" button you can use to display your available credits.
June 16
A new batch job type, search
, provides an asynchronous alternative to POST /v2/search/summaries
for obtaining property IDs.
You upload the search criteria with your request to the batch API (POST /v2/jobs/file
). When the job completes, you can download the resulting property IDs and update times as a single file. Use it when you expect the number of properties meeting the search criteria to be large. For details, see Search jobs.
June 1
The POST /v2/search/summaries
endpoint now includes the location coordinates of each matching property in the API response, for example:
{
"building_update_time": "2020-04-16",
"id": "00dad3be-8ee4-5877-aa0b-028c81929ad4",
"location": {
"lat": 40.70386682632969,
"lon": -73.77635397057318,
},
etc.
}
April 17
New York City (NYC) and National property data have been merged to provide consistent data and unified search across all properties. As a consequence, the Reonomy IDs of NYC properties have changed. See ID mappings for information on updating your scripts. For Reonomy API users, the key benefits of this update are:
null
now return data if it is available for the selected property. POST /v2/search/summaries
endpoint to search for NYC properties using those NYC-only attributes. See NYC-only search attributes for details and an example.
Use the ID mappings to update any scripts that reference Reonomy IDs for NYC properties, as these IDs have changed.
The error message below indicates that you used an invalid property ID.
{
"err_name": "ESResultNotFound",
"message": "No result found for query.",
}
March 31
The POST /v2/jobs/file
(batch API) endpoint now lets you submit up to 100,000 addresses in a single request (up from 10,000). For each matching address, the API returns the Reonomy ID of the property at that location. For more information, see Match jobs.
March 23
The POST /v2/jobs/file
(batch API) endpoint now lets you download data for up to 1 million properties at a time. Additionally, you can specify multiple data types (mortgages
, taxes
, etc.) in a single request. For more information, see Property details jobs.
Feb 7
The new POST /search/property-shapes endpoint lets you search for parcels contained within or intersecting with the specified bounding box (the red rectangle in the example). The response includes the number of properties, as well as the geometry and properties of each parcel. For more information and an example, see Searching for parcels.