Properties

Search properties with filters

POST
/v1/properties

Search and list individual properties/parcels with filters — one row per parcel. Filter by location (state, county, city, zip, address), owner name, property characteristics (beds, baths, square footage, year built, property type), value, and ownership or transaction history, with sorting and cursor pagination. This is the discrete per-property record search: use it to find specific properties or build a filtered property list. (For a single property by its ID use the property detail endpoint.) If you only need how many properties match and not the records themselves, send the same request body to countProperties.

Authorization

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/properties" \  -H "Content-Type: application/json" \  -d '{}'
{
  "cursor": "string",
  "data": [
    {
      "activeLoanCount": 0,
      "activeLoanCountKnown": true,
      "address": "string",
      "apn": "string",
      "avm": {
        "confidence": 0,
        "high": 0,
        "low": 0,
        "mid": 0
      },
      "baths": 0,
      "beds": 0,
      "borrowerStatus": "string",
      "city": "string",
      "coordinates": {
        "lat": 0,
        "lon": 0
      },
      "equity": {
        "pct": 0,
        "value": 0
      },
      "fips": "string",
      "foreclosure": {
        "matched": true,
        "scheduledAuctionDate": "string",
        "status": "string"
      },
      "id": "string",
      "loanCount": 0,
      "loanType": "string",
      "loans": [
        {
          "amount": 0,
          "borrowerStatus": "string",
          "brokerNmls": "string",
          "companyNmls": "string",
          "currentBalance": 0,
          "interestRate": 0,
          "lenderId": "string",
          "lenderName": "string",
          "lenderNmls": "string",
          "loanType": "string",
          "ltv": 0,
          "originatorName": "string",
          "originatorNmls": "string",
          "recordedInterestRate": 0,
          "recordingDate": "string",
          "transactionType": "string"
        }
      ],
      "lotSquareFeet": 0,
      "mmPropertyId": "string",
      "mortgageBalance": 0,
      "ownerFirstName": "string",
      "ownerLastName": "string",
      "ownerName": "string",
      "partialBaths": 0,
      "preSaleLoanCount": 0,
      "recordedInterestRate": 0,
      "saleCount": 0,
      "salePropensity": {
        "category": "string",
        "score": 0
      },
      "sales": {
        "count": 0,
        "firstDate": "string",
        "lastDate": "string",
        "lastPrice": 0
      },
      "scoredAt": "string",
      "squareFeet": 0,
      "state": "string",
      "stories": 0,
      "yearBuilt": 0,
      "zip": "string"
    }
  ],
  "lenderNormalizations": [
    {
      "aliasCount": 0,
      "displayName": "string",
      "id": "string",
      "matchedVia": "id",
      "original": "string",
      "totalDocuments": 0
    }
  ],
  "total": 0
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string",
  "limit": 0,
  "size": 0
}