---
title: "Retrieves a pre-portal listing."
method: GET
path: "/v2/premarket/listings/{id}"
tags: ["PreMarket"]
---

# Retrieves a pre-portal listing.

`GET /v2/premarket/listings/{id}`

## Path parameters

- `id` string, required

## Response `200`

Success

- PreMarketV1ListingResponse — Pre-portal listing response.
  - `id` string, required — Pre-portal listing ID.
  - `listingStatus` 'preMarket' | 'sold' | 'listed' | 'withdrawn' | 'draft', required
  - `relatedAdId` integer, nullable — The Domain Ad Id of the related listing.
  - `providerDetails` PreMarketV1ProviderDetails — Information for the listing provider
    - `providerSystem` string, nullable — Identify the source of the listing
    - `providerAdID` string, nullable — Unique ID within provider system
  - `address` PreMarketV1AddressResponse, required
    - `streetNumber` string, required — Street (and possibly unit) number component of an address. E.g. 23, 1a, 11/1.
    - `street` string, required — Street name, e.g. Punt Road.
    - `suburb` string, required
    - `state` 'nsw' | 'vic' | 'act' | 'sa' | 'wa' | 'tas' | 'qld' | 'nt', required — Australian states
    - `postcode` string, required
    - `slug` string, required
  - `advertiserIdentifiers` PreMarketV1AdvertiserIdentifiers
    - `domainAgencyId` integer, required — Domain Agency Id
    - `contactIds` integer[], nullable — Identifier of each contact the advertiser has associated with the listing
    - `agentIds` string[], nullable — Identifier of each agent the advertiser has associated with the listing
  - `bedrooms` number, float, required — Total number of bedrooms in the property.
  - `bathrooms` number, float, required — Total number of bathrooms in the property.
  - `carspaces` number, float, required — Total number of car spaces in the property.
  - `headline` string, nullable — The short description of the property provided by the advertiser.
  - `description` string, nullable — The long description of the property provided by the advertiser.
  - `authorityExecutedDate` string, date-time, nullable — The date on which the authority contract was executed. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `reservePrice` number, double, nullable — Vendor reserve price.
  - `estimatedSalePrice` PreMarketV1Price, required
    - `from` number, double, required — Lower end of the price range.
    - `to` number, double, required — Upper end of the price range.
    - `displayText` string, nullable — When provided this will be shown instead of the price range, e.g.: "Offers over $450K considered"
  - `propertyTypes` PreMarketV1PropertyType[], nullable — The property types (e.g. house, apartment/unit/flat, etc.).
  - `authorityType` 'privateSale' | 'auction' | 'expressionOfInterest'
  - `exclusivePeriodDays` integer, nullable — The time (in days) that the agent has exclusive authority to sell the property.
  - `exclusiveContinuingPeriodDays` integer, nullable — The time (in days) that exclusive authority has been extended.
  - `exclusivePeriodStartDate` string, date-time, nullable — Start date of the exclusivity period. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `geoLocation` PreMarketV1GeoLocation — Encapsulates the details of a geo location.
    - `latitude` number, double — Latitude of the property.
    - `longitude` number, double — Longitude of the property.
  - `mapCertainty` integer — Map certainty of the property location.
  - `media` PreMarketV1PropertyMedia[], nullable — The media associated with the property provided by the advertiser.
    - `resourceType` 'photograph' | 'floorPlan', required
    - `url` string, required
  - `propertyId` string, nullable — The identifier which uniquely identifies the property being advertised. This may be empty if the Address of property is poorly described.
  - `statementOfInformation` PreMarketV1StatementOfInformation
    - `documentationUrl` string, required — Link to the statement of information documentation file. Must be a PDF file. File should be less than 10 MB in size The Statement of Information must be updated if there is a change in the indicative selling price.
  - `dateCreated` string, date-time — The date/time the listing was created. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `dateUpdated` string, date-time — The date/time the listing was last updated. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `datePreMarket` string, date-time, nullable — The date/time the listing went pre-market. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `dateListed` string, date-time, nullable — The date/time the listing was listed. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `dateSold` string, date-time, nullable — The date/time when the listing status was changed to sold (it is NOT the date/time when the property was sold). The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `dateWithdrawn` string, date-time, nullable — The date/time the listing was withdrawn. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `dateDrafted` string, date-time, nullable — The date/time the listing was drafted. The date is compliant with the ISO 8601 and is in the UTC format, e.g. 2009-06-15T13:45:30.0000000Z.
  - `metadata` object, nullable — Optional listing metadata.
  - `comment` string, nullable — Optional listing comment.
  - `soldDetails` PreMarketV1SoldDetails
    - `soldPrice` integer, nullable — Price the property was sold for.
    - `soldDate` string, date-time, nullable — The date when the property was sold. The date must comply with the ISO 8601 and be in the UTC format, e.g. 2021-10-15T13:45:30.0000000Z.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Server Error

---

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