Updating and Adding property records

Note: before adding or updating a property record. It is recommended you confirm the formatting of the property address. If you are not validating address formats we recommend using our format address endpoint first.

The /property/update route can be used interchangably between adding or updating a property record. If an address is found, it appends to that data.

Important

Roperty strongly reccomends utilizing Address Verfication /address/format before using /property/update to ensure the property address is in valid US format and help keep Roperty's data clean and accessible.

Paramaters

`house_number` - required

`address` - required

`city` - optional

`state` - required

`zipcode` - required

`latitude` - optional

`longitude` - optional

`classification` - required

`json_data` - required

The primary storage of data for the property encoded as a JSON string.

Important

json_data is really up to the contributor to store any type of information like sales price, history, tax records, etc... Be mindful of any sensitive information. We will also provide future guidelines on the information to be entered here.

`history` - optional `json_data` field

When included in json_data, history property should be formatted as an array of associative arrays with date, type, and description as follows:

"history" => [

[

  "date" => '2022-04-21',

  "type" => 'listed',

  "description" => 'Property listed for $123,456'

],

[

  "date" => '2020-08-05',

  "type" => 'sold',

  "description" => 'Property sold for $110,000'

],

]

Code Example

NodeJS

PUT - https://api.roperty.org/api/v1/property/update
var axios = require('axios');
const BEARER_TOKEN = 'SET_ME';
var data = qs.stringify({
  'house_number': '808',
  'address': '808 awesome st',
  'city': 'kansas city',
  'state': 'mo',
  'zipcode': '12345',
  'latitude': '38.897957',
  'lognitude': '-77.036560',
  'json_data': '{&#34;estimate_list_sell_price&#34;:220800,&#34;last_list_or_sold_price&#34;:null,&#34;last_sold_date&#34;:&#34;2022-04-14&#34;,&#34;classification&#34;:&#34;single_family&#34;,&#34;lot_size_ft&#34;:7540,&#34;acreage&#34;:null,&#34;building_size&#34;:1152,&#34;beds&#34;:&#34;3&#34;,&#34;baths&#34;:&#34;2&#34;,&#34;year_built&#34;:&#34;1988&#34;,&#34;heating&#34;:&#34;gas&#34;,&#34;cooling&#34;:&#34;central&#34;,&#34;type&#34;:&#34;single family&#34;,&#34;garage_size&#34;:null,&#34;roof&#34;:&#34;composition&#34;,&#34;interior_features&#34;:null,&#34;appliances&#34;:&#34;dishwasher, refrigerator&#34;,&#34;parking&#34;:&#34;garage - attached, off-street, on-street,&#34;,&#34;annual_tax&#34;:&#34;$1,905&#34;,&#34;available&#34;:&#34;off-market&#34;&#34;,amenities_included&#34;:null,&#34;basement&#34;:&#34;finished&#34;,&#34;,&#34;neighborhood_median&#34;:185000,&#34;open_houses&#34;:[],&#34;history&#34;:[{&#34;date&#34;:&#34;2017-03-20&#34;,&#34;type&#34;:&#34;sold&#34;,&#34;description&#34;:&#34;sold --&#34;}]}'
});
var config = {
  method: 'put',
  url: 'https://api.roperty.org/api/v1/property/update',
  headers: {
    'Authorization': 'Bearer ' + BEARER_TOKEN
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Paramaters​

house_number - required​

address - required​

city - optional​

state - required​

zipcode - required​

latitude - optional​

longitude - optional​

classification - required​

json_data - required​

history - optional json_data field​

Code Example​