---
title: "Search Listings"
method: POST
path: "/v2.0/listings/search"
tags: ["Listing V2"]
---

# Search Listings

`POST /v2.0/listings/search`

Search listings by location keywords and optional filters (price, bedrooms, bathrooms, sqft, property type, listing status, purchase type).

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- ListingQueryRequest
  - `searchScope` 'my' | 'office' | 'all' — Search scope. 'my' = agent's own listings, 'office' = office-level listings, 'all' = all listings the agent has access to. Default 'all'.
  - `soldFlag` boolean — Whether to search sold listings. Default false (active listings).
  - `filterConditions` object — Advanced search filter conditions. Keys must match condition names in the property.condition table. Examples: - "location": {"city": ["Seattle"]} (suggestion type) - "price": "100000,500000" (inputBox range: "min,max") - "beds": "2," (inputBox range: min only) - "baths": ",3" (inputBox range: max only) - "sqFt": "1000,3000" (inputBox range) - "daysOnSite": ",30" (inputBox days: within last N days) - "propertyType": ["Condo", "Townhouse"] (multiSelect labels) - "purchaseType": ["For Sale"] (singleSelect label)
  - `sortFields` string[] — Sort fields. Values from ListingSortEnum, e.g. MLS_LIST_DATE_L_DESC, PRICE_DESC, PRICE_ASC, BEDROOMS_DESC, BATHS_DESC, BUILT_YEAR_DESC, SQFT_DESC, RELEVANCE, QUALITY_DESC, OPEN_HOUSE_DESC.
  - `returnFields` string[] — Return fields. If empty, uses default fields for the listing type.
  - `pageNum` integer — Page number, starting from 1. Default 1.
  - `pageSize` integer — Page size, 1–100. Default 25.

## Response `200`

successful operation

- ListingV2SearchResponse — Search response for ListingV2
  - `listing` ListingItem[]
    - `listingId` string — Listing ID
    - `mlsListingId` string — MLS listing ID
    - `listingStreetName` string — Street address
    - `listingCity` string — City
    - `listingState` string — State abbreviation
    - `listingZipcode` string[]
    - `county` string — County name
    - `area` string — Area name
    - `chimeArea` string — Chime area name
    - `subDivisionName` string, nullable — Subdivision name
    - `community` string, nullable — Community name
    - `chimeComplex` string, nullable — Chime complex
    - `price` string — Listing price
    - `beds` number, float — Number of bedrooms
    - `baths` number, float — Number of bathrooms
    - `sqft` number, float — Square footage
    - `builtYear` integer — Year built
    - `totalAvailableAcres` string — Lot size in sqft
    - `detailsDescribe` string — Full listing description
    - `listingStatus` string — Listing status
    - `purchaseType` string — Purchase type
    - `propertyTypes` string[]
    - `propertyTypePrimary` string — Primary property type
    - `propertyTypeSecondary` string — Secondary property type
    - `pictureList` string[]
    - `openHouseSchedules` string, nullable — Open house schedule text
    - `openHouseSchedulesStart` string, nullable — Open house start datetime
    - `openHouseSchedulesEnd` string, nullable — Open house end datetime
    - `agentId` string — Listing agent ID
    - `agentName` string — Listing agent name
    - `agentOrgId` string — Listing agent org ID
    - `agentOrgName` string — Listing agent org name
    - `coAgentId` string, nullable — Co-agent ID
    - `coAgentName` string, nullable — Co-agent name
    - `coAgentOrgId` string, nullable — Co-agent org ID
    - `coAgentOrgName` string, nullable — Co-agent org name
    - `hoaFee` number, double — HOA fee (-1 if N/A)
    - `hoaFeeFrequency` string, nullable — HOA fee frequency
    - `condoFee` number, double — Condo fee (-1 if N/A)
    - `condoFeeFrequency` string, nullable — Condo fee frequency
    - `chimeMaintenanceFee` number, double — Chime maintenance fee
    - `garageParkingSpaces` number, double — Number of garage/parking spaces
    - `interiorFeatures` string, nullable — Interior features
    - `exterior` string, nullable — Exterior features
    - `mlsListDateL` integer — MLS list date timestamp (0 if unknown)
  - `metadata` ListingV2Metadata
    - `collection` string
    - `pageSize` integer
    - `pageNum` integer
    - `totalCount` integer
    - `totalPage` integer
    - `hasMore` boolean

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)