Reonomy logo

Technical Documentation

Release notes

Mar 2021

Mar 17

New occupant attributes now available

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.

Tenants schema
Jan 2021

Jan 31

Visual schemas now available

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.).

Visual schema
Sept 2020

Sept 11

Obtaining data for multiple properties in a single API call

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 2020

Aug 21

Obtaining multiple detail types in a single API call

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

Excluding personally identifiable information (PII)

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.

PII fields
June 2020

June 22

API credit usage

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.

Credit usage

June 16

Bulk property ID search

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

Location coordinates now available in POST /search/summaries response

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 2020

April 17

New York City data enhancements

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:

  • API requests now return NYC-specific data that was previously unavailable through the API (data supplied by the NYC Department of Buildings not available for properties elsewhere in the country). This means attributes tagged NYC properties only in the Data dictionary that previously returned null now return data if it is available for the selected property.
  • You can use the 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.

 

 

Action required

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 2020

March 31

Resolve up to 100,000 addresses at a time

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

Request data for up to 1 million properties

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, 2020

Feb 7

Search for parcels within a bounding box

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.

Batch job flow

Copyright © 2022 Reonomy® All rights reserved.

Return to reonomy.com