Property Level

Sales History

Examine a property's sales and ownership transfer history for trends, transaction patterns, and investment insights.

Source: Public Records

Pricing Tier: Basic

Updated: Daily

Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</th></tr> <tr><td>slug</td><td>string</td><td>Unique readable string identifier for the property</td><td>123-Main-St-Apt-1B-San-Francisco-CA-94132</td> <td></td></tr> <tr><td>address</td><td>string</td><td>Either a single URL-safe string ("slug") identifying the address, or just a building number, street name, and optionally unit number (if not a slug the payload must also include other identifiers)</td><td>123 Main St</td> <td></td></tr> <tr><td>unit</td><td>string</td><td>Unit number for the property, if needed and not already specified in the address string</td><td>Apt 1B</td> <td></td></tr> <tr><td>city</td><td>string</td><td>City in which the property is located</td><td>San Francisco</td> <td></td></tr> <tr><td>state</td><td>string</td><td>2-letter acronym of the US state in which the property is located</td><td>CA</td> <td></td></tr> <tr><td>zipcode</td><td>string</td><td>5-digit US zipcode in which the property is located</td><td>94105</td> <td></td></tr> <tr><td>order</td><td>string</td><td>Chronological order to sort result items. One of [asc or desc]. Defaults to asc.</td><td></td> <td>[asc, desc]</td></tr> <tr><td>limit</td><td>integer</td><td>Maximum integer number of result items to return. Defaults to null.</td><td>10</td> <td></td></tr> <tr><td>start</td><td>string</td><td>Beginning date limit for result items, based on record_date, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td> <td></td></tr> <tr><td>end</td><td>string</td><td>Ending date limit for result items, based on record_date, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td> <td></td></tr> </table>

Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>[]</td><td>object</td><td></td><td></td> </tr> <tr><td>[].amount</td><td>integer</td><td>Amount in dollars that the property sold for</td><td>350000</td> </tr> <tr><td>[].apn</td><td>string</td><td>Assessor's Parcel Number or Parcel Identification Number</td><td>123456789</td> </tr> <tr><td>[].event_type</td><td>string</td><td>Type of sale</td><td>Sale</td> </tr> <tr><td>[].fips</td><td>string</td><td>5-digit Federal Information Processing Standards county code</td><td>06001</td> </tr> <tr><td>[].grantee_1</td><td>string</td><td>Last name of first person listed on deed</td><td>Smith</td> </tr> <tr><td>[].grantee_1_forenames</td><td>string</td><td>First name of first person listed on deed</td><td>John</td> </tr> <tr><td>[].grantee_2</td><td>string</td><td>Last name of second person listed on deed</td><td>Johnson</td> </tr> <tr><td>[].grantee_2_forenames</td><td>string</td><td>First name of second person listed on deed</td><td>Jane</td> </tr> <tr><td>[].grantor_1</td><td>string</td><td>Name of the primary financier of the deed</td><td>Bank of Example</td> </tr> <tr><td>[].grantor_2</td><td>string</td><td>Name of the secondary financier of the deed</td><td>Mortgage Corp</td> </tr> <tr><td>[].record_book</td><td>string</td><td>Record book number for the recorded deed. A unique transaction in many counties may be defined in the recorder's books by a unique: record_book, record_page, record_doc.</td><td>12345</td> </tr> <tr><td>[].record_date</td><td>string</td><td>Date of lien origination</td><td>2023-08-10</td> </tr> <tr><td>[].record_doc</td><td>string</td><td>The assessor's document number for this lien. A unique transaction in many counties may be defined in the recorder's books by a unique: record_book, record_page, record_doc.</td><td>987654</td> </tr> <tr><td>[].record_page</td><td>string</td><td>Record page of the lien in the county recorder. A unique transaction in many counties may be defined in the recorder's books by a unique: record_book, record_page, record_doc.</td><td>789</td> </tr> </table>
get/v2/property/sales_history

Query parameters

slugstring

Unique readable string identifier for the property

addressstring required

Either a single URL-safe string ("slug") identifying the address, or just a building number, street name, and optionally unit number (if not a slug the payload must also include other identifiers)

unitstring

Unit number for the property, if needed and not already specified in the address string

citystring

City in which the property is located

statestring

2-letter acronym of the US state in which the property is located

zipcodestring

5-digit US zipcode in which the property is located

order'asc' | 'desc' nullable

Chronological order to sort result items. One of [asc or desc]. Defaults to asc.

limitinteger nullable

Maximum integer number of result items to return. Defaults to null.

startstring date nullable

Beginning date limit for result items, based on record_date, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.

endstring date nullable

Ending date limit for result items, based on record_date, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.

Response

Success

Example response

[
  {
    "property/sales_history": {
      "result": [
        {
          "amount": 350000,
          "apn": "123456789",
          "event_type": "Sale",
          "fips": "06001",
          "grantee_1": "Smith",
          "grantee_1_forenames": "John",
          "grantee_2": "Johnson",
          "grantee_2_forenames": "Jane",
          "grantor_1": "Bank of Example",
          "grantor_2": "Mortgage Corp",
          "record_book": "12345",
          "record_date": "2023-08-10",
          "record_doc": "987654",
          "record_page": "789"
        }
      ]
    },
    "address_info": {
      "address_full": "123 Main St San Francisco CA 94132",
      "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
      "address": "123 Main St",
      "unit": "Apt 1B",
      "city": "San Francisco",
      "state": "CA",
      "zipcode": "94132",
      "zipcode_plus4": "1234",
      "block_id": "060750313013007",
      "blockgroup_id": "060750201004",
      "county_fips": "06075",
      "metrodiv": "41860",
      "msa": "41860",
      "geo_precision": "rooftop",
      "lat": 37.789,
      "lng": -122.401,
      "status": {
        "match": true,
        "details": [
          "Address fully verified"
        ],
        "requested_item": {
          "zipcode": "94132",
          "address": "123+Main+St"
        },
        "changes": [
          "State added or changed"
        ]
      }
    }
  }
]