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>Query parameters
Unique readable string identifier for the property
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)
Unit number for the property, if needed and not already specified in the address string
City in which the property is located
2-letter acronym of the US state in which the property is located
5-digit US zipcode in which the property is located
Chronological order to sort result items. One of [asc or desc]. Defaults to asc.
Maximum integer number of result items to return. Defaults to null.
Beginning date limit for result items, based on record_date, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.
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"
]
}
}
}
]