---
title: "Suburb Performance by State/Suburb/Postcode"
method: GET
path: "/v2/suburbPerformanceStatistics/{state}/{suburb}/{postcode}"
tags: ["Statistics"]
---

# Suburb Performance by State/Suburb/Postcode

`GET /v2/suburbPerformanceStatistics/{state}/{suburb}/{postcode}`

Retrieve suburb performance data by state, suburb and postcode

## Path parameters

- `state` 'NSW' | 'VIC' | 'QLD' | 'SA' | 'WA' | 'TAS' | 'NT' | 'ACT', required
- `suburb` string, required
- `postcode` string, required

## Query parameters

- `propertyCategory` 'House' | 'Unit'
- `bedrooms` integer
- `periodSize` 'quarters' | 'halfYears' | 'years'
- `startingPeriodRelativeToCurrent` integer
- `totalPeriods` integer

## Response `200`

Statistics data returned

- SuburbPerformance
  - `header` object
    - `suburb` string
    - `state` string
    - `propertyCategory` string
  - `series` object
    - `seriesInfo` object[]
      - `year` integer
      - `month` integer
      - `values` object
        - `medianSoldPrice` integer
        - `numberSold` integer
        - `highestSoldPrice` integer
        - `lowestSoldPrice` integer
        - `5thPercentileSoldPrice` integer
        - `25thPercentileSoldPrice` integer
        - `75thPercentileSoldPrice` integer
        - `95thPercentileSoldPrice` integer
        - `medianSaleListingPrice` integer
        - `numberSaleListing` integer
        - `highestSaleListingPrice` integer
        - `lowestSaleListingPrice` integer
        - `auctionNumberAuctioned` integer
        - `auctionNumberSold` integer
        - `auctionNumberWithdrawn` integer
        - `daysOnMarket` integer
        - `discountPercentage` number, float
        - `medianRentListingPrice` integer
        - `numberRentListing` integer
        - `highestRentListingPrice` integer
        - `lowestRentListingPrice` integer
        - `meanRentYield` number, float

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Unexpected error

---

[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/versions/24ab78aba827/schema)