---
title: "Sales Listing History"
method: GET
path: "/v1/properties/salesHistory"
tags: ["Properties"]
---

# Sales Listing History

`GET /v1/properties/salesHistory`

Search for a specific property's activities and provide sale/rental activity if found. Supply either propertyId, gnafId, or all address fields (with flatNumber optional)

## Query parameters

- `propertyId` string
- `gnafId` string
- `flatNumber` string
- `streetNumber` string
- `streetName` string
- `streetType` string
- `postcode` string
- `suburbName` string
- `state` 'ACT' | 'NSW' | 'NT' | 'QLD' | 'SA' | 'TAS' | 'VIC' | 'WA' | 'OT'

## Response `200`

Property matching specified criteria was found

- PropertyEnrichmentV2SaleHistory
  - `propertyId` string — Unique ID for the property
  - `addressComponents` PropertyEnrichmentV2AddressBasic — Address of property
    - `flatNumber` string, nullable
    - `streetNumber` string
    - `streetName` string
    - `streetType` string, nullable
    - `streetTypeLong` string, nullable
    - `suburb` string
    - `postcode` string
    - `state` string
  - `salesHistory` PropertyEnrichmentV2SaleHistoryListing[] — An array of the sale histories for the listing
    - `id` string
    - `agencyName` string, nullable
    - `agencyId` integer, nullable
    - `firstListedDate` string, date, nullable — First activity date in YYYY-MM-DD format
    - `lastListedDate` string, date, nullable — Last activity date in YYYY-MM-DD format
    - `lastListedPrice` number, nullable
    - `daysOnMarket` integer, nullable
    - `soldDate` string, date, nullable — Sold date in YYYY-MM-DD format
    - `soldPrice` number, nullable — sold price
    - `saleType` string, nullable — Sale type ['Auction', 'Private Treaty']
  - `rentalHistory` PropertyEnrichmentV2RentHistoryListing[] — An array of the rent histories for the listing
    - `id` string
    - `agencyName` string, nullable
    - `agencyId` integer, nullable
    - `firstListedDate` string, date, nullable — First activity date in YYYY-MM-DD format
    - `lastListedDate` string, date, nullable — Last activity date in YYYY-MM-DD format
    - `lastListedPrice` number, nullable
    - `daysOnMarket` integer, nullable

## Other responses

- `300` — Multiple records found
- `400` — Bad request
- `401` — Unauthorized
- `404` — A property with the specified ID was not found
- `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/revisions/cc7620662261/schema)