Pre-Foreclosures

basic pre_foreclosure search

let request = {
  size: 200,
  pre_foreclosure: true,
  city: 'San Francisco',
  state: 'CA'
}

//with notice_type


//with notice_type & search_range

Find NODs (Notice of Default) in the last month

let request = {
  size: 200,
  pre_foreclosure: true,
  notice_type: "NOD",
  search_range: "1_MONTH",
  city: 'San Francisco',
  state: 'CA'
}

Use pre_foreclosure_date_min & pre_foreclosure_date_max in place of "search_range" to be more precise with your date range (November 2023 in this example)

let request = {
  size: 200,
  pre_foreclosure: true,
  notice_type: "NOD",
  pre_foreclosure_date_min: "2023-11-01",
  pre_foreclosure_date_max: "2023-11-31",
  city: 'San Francisco',
  state: 'CA'
}

Foreclosures

the foreclosure [bool] flag works great with the corresponding date filters
without specifying the date filters, you are at risk of pulling back historical foreclosures that may be inactive
- always make sure to check the .recordingDate in each .foreclosureInfo object from the Property Detail response

let request = {
  "size": 10,
  "ids_only": true,
  "foreclosure": true,
  "foreclosure_date_min": "2025-09-01",
  "foreclosure_date_max": "2026-01-01",
  "state": "CA"
}

REO

Find Banked Owned Properties

let request = {
  size: 50,
  reo: true,
  city: 'Boise',
  state: 'ID'
}

With a Time Range - searches over foreclosures and document types that reflect purchase by bank, trust, service entity, or tax entity

let request = {
  size: 50,
  reo: true,
  search_range: "6_MONTH",
  city: 'Boise',
  state: 'ID'
}

(Upcoming) Auctions

basic auction search

let request = {
  size: 50,
  auction: true,
  city: 'Boise',
  state: 'ID'
}

auction search with time range to find timely auctions

let request = {
  size: 50,
  auction: true,
  search_range: "1_MONTH",
  city: 'Boise',
  state: 'ID'
}

auction with exact date range

let request = {
  size: 50,
  auction: true,
  auction_date_min: "2023-12-20",
  auction_date_max: "2024-01-10",
  city: 'Boise',
  state: 'ID'
}

Document Types

For more specific document type searches to go along with these fields, please visit Document Types Reference

last_opening_bid_amount_min / last_opening_bid_amount_max => filter by bid amount in .foreclosureInfo/.auctionInfo • last_judgment_amount_min / last_judgment_amount_max => filter by judgment amount in .foreclosureInfo • last_trustee_full_name (string) => filter NTS notice type properties by a specific trustee name