location | STRING | Optional | City, county or ZIP — anything auction.com's autocomplete resolves, e.g. `Dallas, TX`, `Cook County, IL`, `60628`. The top suggestion wins; use [/autocomplete](https://realtyapi.io/dashboard?tab=playground&api=auction&endpoint=autocomplete) to preview matches. **Omit for a nationwide search.** |
page | NUMBER | Optional | Page number of the result window (default `1`). Combine with `resultCount`. An explicit `offset` param is also accepted and overrides the page math. |
resultCount | NUMBER | Optional | Results per page — default `50`, maximum `250` (aliases: `limit`, `pageSize`). |
sort | ENUM | Optional | Sort order. Default `auction_date` — soonest auction first. `newest` / `oldest` sort by when the listing was activated, `price_low` / `price_high` by the auction starting bid, `distance` by proximity (only meaningful on [/search/bycoordinates](https://realtyapi.io/dashboard?tab=playground&api=auction&endpoint=searchbycoordinates)). Values: auction_date, newest, oldest, price_low, price_high, distance |
availability | ENUM | Optional | Listing availability. `active` (default) = live & upcoming auctions currently on the marketplace. `removed` = closed/ended listings (sold, cancelled, or pulled from auction). Aliases accepted when calling directly: `closed`, `ended`, `sold`, `past`, `inactive` all map to `removed`. Values: active, removed |
buyingType | ENUM | Optional | Buying type, using auction.com's own labels: `Foreclosure Homes` = trustee/courthouse foreclosure auctions (incl. pre-foreclosure), `REO Bank Owned` = bank-owned (REO) inventory, `Private Seller` = private-seller and short-sale listings, `Any` = no filter. Slug forms (`foreclosure`, `bank-owned`, `reo`, `private-seller`, `short-sale`) are accepted too. Matched client-side against each listing's `assetType` (see the scan-window note on the price filters). Tip: foreclosure inventory is courthouse-sale driven and thin in some states — browse foreclosure *events* on [/calendar](https://realtyapi.io/dashboard?tab=playground&api=auction&endpoint=calendar). Values: Any, Foreclosure Homes, REO Bank Owned, Private Seller |
assetType | STRING | Optional | Finer-grained alternative to `buyingType`: a comma-separated list of asset-type enums — `FORECLOSURE`, `PRE_FORECLOSURE`, `BANK_OWNED`, `REO`, `PRIVATE_SELLER`, `SHORT_SALE`. Example: `FORECLOSURE,PRE_FORECLOSURE`. Client-side filter — applied over the first 250 listings fetched, so `total` reflects matches within that scan window. |
propertyType | ENUM | Optional | Property structure type, matched client-side against the listing's `propertyType` / `propertyTypeGroup` (`house` covers all SINGLE_FAMILY variants, `condo` covers condominium units, `multi_family` covers multi-unit buildings). A comma-separated combination (e.g. `house,condo`) is accepted when calling the API directly. Client-side filter — applied over the first 250 listings fetched, so `total` reflects matches within that scan window. Values: house, condo, townhouse, multi_family, mobile, land, commercial |
minPrice | NUMBER | Optional | Minimum price in USD. Price = the auction **starting bid** when available, otherwise the property valuation. Client-side filter — applied over the first 250 listings fetched, so `total` reflects matches within that scan window. Listings with no price data are excluded while a price filter is set. |
maxPrice | NUMBER | Optional | Maximum price in USD — see `minPrice` for how the price is derived. |
minBeds | NUMBER | Optional | Minimum bedrooms. Client-side filter — applied over the first 250 listings fetched, so `total` reflects matches within that scan window. Listings without bedroom data are excluded while set. |
maxBeds | NUMBER | Optional | Maximum bedrooms (see `minBeds`). |
minBaths | NUMBER | Optional | Minimum bathrooms. Client-side filter — applied over the first 250 listings fetched, so `total` reflects matches within that scan window. Listings without bathroom data are excluded while set. |
maxBaths | NUMBER | Optional | Maximum bathrooms (see `minBaths`). |
minSqft | NUMBER | Optional | Minimum living-area square footage. Client-side filter — applied over the first 250 listings fetched, so `total` reflects matches within that scan window. Listings without square-footage data are excluded while set. |
maxSqft | NUMBER | Optional | Maximum living-area square footage (see `minSqft`). |
minYear | NUMBER | Optional | Earliest year built. Client-side filter — applied over the first 250 listings fetched, so `total` reflects matches within that scan window. Listings without year-built data are excluded while set. |
maxYear | NUMBER | Optional | Latest year built (see `minYear`). |
occupancy | ENUM | Optional | Occupancy status — a key auction-buying differentiator (an `OCCUPIED` foreclosure needs eviction / leaseback diligence; `VACANT` usually allows faster possession). Server-side filter. Values: OCCUPIED, VACANT, OWNER_OCCUPIED, TENANT_OCCUPIED, ADVERSELY_OCCUPIED |
presale | BOOLEAN | Optional | Set `true` to return only pre-foreclosure (presale) listings — properties scheduled for foreclosure that have not gone to auction yet. |
keywords | STRING | Optional | Free-text search over listings (aliases: `search`, `query`, `q`). |