Notice of Default (Batch)

Obtain non-rescinded Notice of Default (NOD) events for properties, useful for assessing potential foreclosure risks and investment viability.

Source: HouseCanary, 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>order</td><td>string</td><td>Chronological order to sort result items</td><td></td> <td>[asc, desc]</td></tr> <tr><td>limit</td><td>integer</td><td>Maximum integer number of result items to return</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</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</td><td>2015-01-01</td> <td></td></tr> </table>

Request Body Fields

<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>[].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> </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> </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> </tr> <tr><td>[].city</td><td>string</td><td>City in which the property is located</td><td>San Francisco</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> </tr> <tr><td>[].zipcode</td><td>string</td><td>5-digit US zipcode in which the property is located</td><td>94105</td> </tr> </table>

Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>apn</td><td>string</td><td>Assessor's Parcel Number or Parcel Identification Number</td><td>1234567890</td> </tr> <tr><td>event_type</td><td>string</td><td>Type of notice</td><td>foreclosure</td> </tr> <tr><td>fips</td><td>string</td><td>5-digit Federal Information Processing Standards county code</td><td>06037</td> </tr> <tr><td>record_book</td><td>string</td><td>Record book number for the recorded 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>RB12345</td> </tr> <tr><td>record_date</td><td>string</td><td>Date the lien originated</td><td>2023-01-15</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>DOC56789</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>PG123</td> </tr> </table>

[
  {
    "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
    "address": "123 Main St",
    "unit": "Apt 1B",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94105"
  }
]

[
  {
    "property/nod": {
      "result": {
        "apn": "1234567890",
        "event_type": "foreclosure",
        "fips": "06037",
        "record_book": "RB12345",
        "record_date": "2023-01-15",
        "record_doc": "DOC56789",
        "record_page": "PG123"
      }
    },
    "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"
        ]
      }
    }
  }
]