v1

latestOpenAPI 3.0.42026-08-04108409993.8 KB

PreMarket

Retrieves a pre-portal listing.

get/v2/premarket/listings/{id}

Path parameters

idstring required

Pre-portal listing ID.

Response

Success

idstring required

Pre-portal listing ID.

listingStatus'preMarket' | 'sold' | 'listed' | 'withdrawn' | 'draft' required

relatedAdIdinteger nullable

The Domain Ad Id of the related listing.

bedroomsnumber float required

Total number of bedrooms in the property.

bathroomsnumber float required

Total number of bathrooms in the property.

carspacesnumber float required

Total number of car spaces in the property.

headlinestring nullable

The short description of the property provided by the advertiser.

descriptionstring nullable

The long description of the property provided by the advertiser.

authorityExecutedDatestring 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.

reservePricenumber double nullable

Vendor reserve price.

propertyTypesPreMarketV1PropertyType[] nullable

The property types (e.g. house, apartment/unit/flat, etc.).

authorityType'privateSale' | 'auction' | 'expressionOfInterest'

exclusivePeriodDaysinteger nullable

The time (in days) that the agent has exclusive authority to sell the property.

exclusiveContinuingPeriodDaysinteger nullable

The time (in days) that exclusive authority has been extended.

exclusivePeriodStartDatestring 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.

mapCertaintyinteger

Map certainty of the property location.

propertyIdstring nullable

The identifier which uniquely identifies the property being advertised. This may be empty if the Address of property is poorly described.

dateCreatedstring 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.

dateUpdatedstring 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.

datePreMarketstring 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.

dateListedstring 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.

dateSoldstring 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.

dateWithdrawnstring 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.

dateDraftedstring 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.

metadataobject nullable

Optional listing metadata.

commentstring nullable

Optional listing comment.