Last/Latest Sale Searches (saleHistory[0] / lastSale)

"last_sale_date_min/max" & "last_sale_price_min/max"

• will grab properties with a last sale that was non-arms length OR arms length, whichever is most recent
• the list of results may contain a mixture of non-arms length sales and arms length sales

{
  "size": 100,
  "city": "Richmond",
  "state": "VA",
  "last_sale_date_min": "2025-01-01",
  "last_sale_date_max": "2026-01-01"
}

"latest_arms_length_sale_date_min/max" & "latest_arms_length_sale_amount_min/max"

{
  "size": 10,
  "city": "Richmond",
  "state": "VA",
  "latest_arms_length_sale_date_min": "2025-01-01",
  "latest_arms_length_sale_date_max": "2026-01-01",
  
  "latest_arms_length_sale_amount_min": 100000,
  "latest_arms_length_sale_amount_max": 500000
}

"latest_non_arms_length_sale_date_min/max"

• there is no associated filter for the sale price for this since by their very nature, all non-arms length transactions will have a saleAmount of 0

{
  "size": 10,
  "city": "Richmond",
  "state": "VA",
  "latest_non_arms_length_sale_date_min": "2025-01-01",
  "latest_non_arms_length_sale_date_max": "2026-01-01"
}

Prior Sale Searches (saleHistory[1])

• access the second sale entry from the saleHistory array

"prior_arms_length_sale_date_min/max" & "prior_arms_length_sale_amount_min/max"

• useful for looking at flips

{
  "size": 10,
  "city": "Richmond",
  "state": "VA",
  "prior_arms_length_sale_date_min": "2025-01-01",
  "prior_arms_length_sale_date_max": "2026-01-01",
  
  "prior_arms_length_sale_amount_min": 100000,
  "prior_arms_length_sale_amount_max": 500000
}

"prior_non_arms_length_sale_date_min/max"

• there is no associated filter for the sale price for this since by their very nature, all non-arms length transactions will have a saleAmount of 0

{
  "size": 10,
  "city": "Richmond",
  "state": "VA",
  "prior_non_arms_length_sale_date_min": "2025-01-01",
  "prior_non_arms_length_sale_date_max": "2026-01-01"
}

Find Flipped Properties

• the below range filters are used to specify a range of what you define as a "flip" property
• common month values include 12 (for 12 months/1 year), 18 months, or 24 months
• "prior_owner_individual" [bool] flag can be passed without the min/max filters here, but the min/max filters require the flag to be passed

{
	"prior_owner_individual": true,
  "prior_owner_months_owned_min": 12,
  "prior_owner_months_owned_max": 18 
}