---
title: "Retrieves commercial listings matching the specified criteria."
method: POST
path: "/v1/listings/commercial/_search"
tags: ["Listings"]
---

# Retrieves commercial listings matching the specified criteria.

`POST /v1/listings/commercial/_search`

## Request body

- DomainPublicAdapterWebApiModelsV1ListingsCommercialSearchRequest — Listing search criteria
  - `pageNumber` integer
  - `advertiserId` integer — Agency ID
  - `pageSize` integer — Search results page size
  - `propertyTypes` string[] — Listing property types
  - `price` DomainPublicAdapterWebApiModelsV1ListingsCommercialPriceSearch — Search criteria. Price
    - `min` integer — Minimum price. null - no minimum price limit
    - `max` integer — Maximum price. null - no maximum price limit
    - `type` 'totalAmount' | 'perSqm' — Price type
  - `locations` DomainPublicAdapterWebApiModelsV1ListingsCommercialLocationSearch[] — Location search criteria
    - `area` string — Location area
    - `postcode` string — Location postcode
    - `region` string — Location region
    - `state` 'act' | 'nsw' | 'qld' | 'vic' | 'sa' | 'wa' | 'nt' | 'tas' — State
    - `street` string — Street address
    - `suburb` string — Suburb
  - `keywords` string[] — Search listings by keyword
  - `geoWindow` DomainPublicAdapterWebApiModelsV1ListingsCommercialGeoWindow — Polygon which specifies geographical area for listing search
    - `polygon` DomainPublicAdapterWebApiModelsV1ListingsCommercialGeoPoint[] — List of points making polygon
      - `lat` number, double — Location latitude
      - `long` number, double — Location longitude
    - `boundingBox` DomainPublicAdapterWebApiModelsV1ListingsCommercialGeoPoint[] — Bounding box. Not used
      - `lat` number, double — Location latitude
      - `long` number, double — Location longitude
  - `landAreaMin` integer — Minimum land area
  - `landAreaMax` integer — Maximum land area
  - `buildingSizeMin` integer — Minimum building area
  - `buildingSizeMax` integer — Maximum building area
  - `searchMode` 'forSale' | 'forLease' | 'sold' | 'leased' — Search mode
  - `occupancy` string — Occupancy
  - `sort` 'default' | 'newestFirst' | 'cheapestTotalFirst' | 'cheapestPerSqmFirst' | 'mostExpensiveTotalFirst' | 'mostExpensivePerSqmFirst' | 'suburbAsc' | 'suburbDesc' | 'buildingSizeAsc' | 'buildingSizeDesc' — Sorting order
  - `saleType` 'standardSale' | 'auction' | 'expressionOfInterest' | 'tender' — Sale type
  - `propertyTitle` 'freehold' | 'strata' | 'noBuilding' — Property title
  - `parking` DomainPublicAdapterWebApiModelsV1ListingsCommercialParkingSearch — Listing search. Parking search criteria
    - `type` 'onSite' | 'onStreet' | 'noParking' — Parking type
    - `carspaces` integer — Minimum carspace count
  - `exclusionTypes` string[] — Exclusion Types
  - `annualReturn` integer — Minimum annual return (in percents)

## Response `200`

OK

- DomainPublicAdapterWebApiModelsV1ListingsCommercialListing[]
  - `ad` DomainPublicAdapterWebApiModelsV1ListingsCommercialAd — Listing details
    - `adType` string — Product type
    - `url` string — URL of property details page on CRE website
  - `price` string — Formatted listing price
  - `advertiser` DomainPublicAdapterWebApiModelsV1ListingsCommercialAdvertiser — Agency details
    - `address` string — agency address
    - `id` integer — Agency ID
    - `name` string — Agency Name
    - `preferredColorHex` string — Agency color
    - `images` DomainPublicAdapterWebApiModelsV1ListingsCommercialAdvertiserImages — Agency images (logos, banners)
      - `agencyBannerImageUrl` string — Agency branding banner image URL
      - `agencyBannerWideImageUrl` string — Not used
      - `logoUrl` string — Agency logo. Note: CRE has two logo sizes.
    - `contacts` DomainPublicAdapterWebApiModelsV1ListingsCommercialContact[] — Agency contacts
      - `id` integer — Agent identifier
      - `firstName` string — First name. Not available in CRE
      - `lastName` string — Last name. Not available in CRE
      - `imageUrl` string — Image URL
      - `displayFullName` string — Full name
      - `phoneNumbers` DomainPublicAdapterWebApiModelsV1ListingsCommercialPhoneNumber[] — Phone numbers
        - `displayLabel` string — Diplay label
        - `type` string — Type: \"fax\", \"mobile\", \"telephone\"
        - `number` string — Phone number
      - `emailAddress` string — E-mail address
      - `address` string — Full address
    - `isConjunctional` boolean — Checks whether advertiser is conjunctional or not
  - `geoLocation` DomainPublicAdapterWebApiModelsV1ListingsCommercialGeoLocation — Geographic coordinate
    - `latitude` number, double — Latitude
    - `longitude` number, double — Longitude
  - `propertyArea` string — Building size
  - `propertyType` string — Property type
  - `address` string — Full address
  - `headline` string — Headline
  - `hasVideo` boolean — Has video?
  - `media` DomainPublicAdapterWebApiModelsV1ListingsCommercialMedia[] — Media resources for listing (images, video, floor plans)
    - `dateCreated` string, date-time — Not used
    - `imageUrl` string — Resource URL
    - `mediaType` string — Media type: \"image\", \"video\"
    - `type` string — Type: \"youtube\", \"vimeo\", \"mp4\"
    - `videoUrl` string — Video URL
  - `auctionDate` string — Auction date
  - `id` integer — AdID
  - `metadata` DomainPublicAdapterWebApiModelsV1ListingsCommercialMetadata — Listing metadata
    - `addressComponents` DomainPublicAdapterWebApiModelsV1ListingsCommercialAddressComponents — Address components
      - `area` string — Listing Area
      - `district` string — Not used
      - `postcode` string — Postcode
      - `region` string — Listing Region
      - `stateShort` string — AUS State. 2 or 3 characters
      - `street` string — Street address
      - `streetNumber` string — Street number
      - `suburb` string — Suburb
      - `unitNumber` string — Unit number
  - `carspaceCount` integer — Car parking spaces count

---

[API](https://skmtc.net/domain/apis/domain-public-api.md) · [All operations](https://skmtc.net/domain/apis/domain-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/domain/domain-public-api/revisions/65b1767a4ca7/schema)