Pre-Foreclosures

basic pre_foreclosure search

Note: Use notice_type to filter by foreclosure notice type. Add search_range to filter by time period.

{
  "size": 200,
  "pre_foreclosure": true,
  "city": "San Francisco",
  "state": "CA"
}

Find NODs (Notice of Default) in the last month

{
  "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)

{
  "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

{
  "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

{
  "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

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

(Upcoming) Auctions

basic auction search

{
  "size": 50,
  "auction": true,
  "city": "Boise",
  "state": "ID"
}

auction search with time range to find timely auctions

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

auction with exact date range

{
  "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