# listings_list

> Search for property listings by address, MLS number, status, or price range.

<!-- Source: https://docs.actuallycare.com/tools/listings/listings_list -->

Search for property listings by address, MLS number, status, or price range. Returns pagination info (total_count, has_more, offset, limit) for batch operations. Results include: id, property_address, city, state, zip_code, list_price, listing_status, property_type, bedrooms, bathrooms, square_feet, created_at. Filter by status to find active listings vs sold/expired. Use min_price/max_price to match buyer budgets. For a specific listing by ID, use [`listings_get`](/tools/listings/listings_get) instead. For aggregate stats, use [`listings_stats`](/tools/listings/listings_stats). Default limit is 20 when not provided; if the default is used and more results exist, the response includes truncated: true and total: N so you can rerun with a higher limit.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search term — matches against property_address, city, and mls_number (case-insensitive partial match). |
| `status` | enum | No | Filter by listing status. active=on market, pending=under contract, sold=closed, expired=listing ended, coming_soon=pre-market (default: all). · One of: `all`, `active`, `pending`, `sold`, `expired`, `cancelled`, `coming_soon` |
| `min_price` | number | No | Minimum listing price in dollars. Use with max_price for buyer matching. · Min: 0 |
| `max_price` | number | No | Maximum listing price in dollars. Use with min_price for buyer matching. · Min: 0 |
| `property_type` | enum | No | Filter by property type. · One of: `single_family`, `condo`, `townhouse`, `multi_family`, `land`, `commercial` |
| `limit` | number | No | Maximum results (default: 20, max: 500). When omitted and more results exist, response includes truncated: true + total: N. · Max: 500 · Min: 1 |
| `offset` | number | No | Skip N results for pagination (default: 0). · Min: 0 |

## Example prompts

- "Find active single family listings between 400k and 550k for the Garcias."
- "Search my listings for anything on Birchwood Ln in Bakersfield."

## Safety

**Read-only.** This tool never changes your data — it only looks things up. Safe to run anytime.

## Previous name

This tool was previously published as `search_listings`. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.