--- title: "Gets listing using the contact id" method: GET path: "/v1/agents/{id}/listings" tags: ["Agents"] --- # Gets listing using the contact id `GET /v1/agents/{id}/listings` ## Path parameters - `id` integer, required ## Query parameters - `dateUpdatedSince` string, date-time - `includedArchivedListings` boolean - `pageNumber` integer - `pageSize` integer ## Response `200` OK - ListingsV1Listing[] - `objective` 'sale' | 'rent', nullable — Gets or Sets Objective - `status` 'unknown' | 'archived' | 'underOffer' | 'sold' | 'leased' | 'newDevelopment' | 'recentlyUpdated' | 'new' | 'live' | 'pending' | 'depositTaken', nullable — Gets or Sets Status - `saleMode` 'buy' | 'rent' | 'share' | 'sold' | 'leased' | 'archived', nullable — Gets or Sets SaleMode - `channel` 'residential' | 'commercial' | 'business', nullable — Gets or Sets Channel - `id` integer, required — The identifier which uniquely identifies the listing. - `addressParts` ListingsV1AddressParts — Encapsulates the parts that make up an Address - `stateAbbreviation` 'nsw' | 'vic' | 'sa' | 'nt' | 'tas' | 'act' | 'qld' | 'wa', nullable — Gets or Sets StateAbbreviation - `displayType` 'fullAddress' | 'streetAndSuburb' | 'suburbOnly' | 'regionOnly' | 'areaOnly' | 'stateOnly', nullable — Gets or Sets DisplayType - `streetNumber` string, nullable — Street number - `unitNumber` string, nullable — Unit number. - `street` string, nullable — Street address - `suburb` string, nullable — Suburb of the address - `suburbId` integer, nullable — Domain suburb identifier for address lookup via the domain location api - `postcode` string, nullable — Postcode of the address - `displayAddress` string, nullable — Advertiser's preference in displaying their listing's address - `advertiserIdentifiers` ListingsV1AdvertiserIdentifiers, required — Encapsulates the listing's advertiser identifiers - `advertiserType` 'agency' | 'private', nullable — Gets or Sets AdvertiserType - `advertiserId` integer, nullable — Advertiser's identifier - `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 - `conjunctionContactIds` integer[], nullable — Identifier of each conjunctional contact associated with the listing - `conjunctionAgentIds` string[], nullable — Identifier of each conjunctional agent associated with the listing - `apmIdentifiers` ListingsV1AustralianPropertyMonitorsIdentifiers — APM Identifiers - `addressId` integer, nullable — APM address identifier - `streetId` integer, nullable — APM street identifier - `suburbId` integer, nullable — APM suburb identifier - `cadastreId` integer, nullable — APM cadastre identifier - `postcodeId` integer, nullable — APM postcode identifier - `stateId` integer, nullable — State identifier - `state` string, nullable — APM State - `propertyTypeId` integer, nullable — APM property type identifier - `propertyTypeCategoryId` integer, nullable — APM property category type identifier - `streetNumber` string, nullable — APM washed and standardized address component for the street number, (including any prefixes, suffixed and composite numbers e.g. \"2-4a\") - `bathrooms` number, float, nullable — Total number of bathrooms in the property - `bedrooms` number, float, nullable — Total number of bedrooms in the property; Studio apartments have a value of \"0\" - `buildingArea` string, nullable — The building area display value of the property e.g. 160 ha - `buildingAreaSqm` number, double, nullable — The properties building area in square meters - `carspaces` number, float, nullable — Total number of car spaces in the property. - `dateAvailable` string, date-time, nullable — The date the property is available. DateTime is in a local timezone. - `dateCreated` string, date-time, nullable — The date/time the listing was created. DateTime is in AEST (Australian Eastern Standard Time) or AEDT (Australian Eastern Daylight Time) timezone. - `dateUpdated` string, date-time, nullable — The date/time the listing had major update. DateTime is in AEST (Australian Eastern Standard Time) or AEDT (Australian Eastern Daylight Time) timezone. - `dateMinorUpdated` string, date-time, nullable — When minor update applied to the listing. DateTime is in AEST (Australian Eastern Standard Time) or AEDT (Australian Eastern Daylight Time) timezone. - `datePurged` string, date-time, nullable — The date/time the listing was purged. It's only returned for archived listings. DateTime is in AEST (Australian Eastern Standard Time) or AEDT (Australian Eastern Daylight Time) timezone. - `dateListed` string, date-time, nullable — The date/time last listed. DateTime is in AEST (Australian Eastern Standard Time) or AEDT (Australian Eastern Daylight Time) timezone. - `description` string, nullable — The long description of the property provided by the advertiser. - `devProjectId` integer, nullable — The ID of the development project - null if no associated project - `energyEfficiencyRating` integer, nullable — Energy Efficiency Rating value for ACT properties - `features` string[], nullable — The property features specified by the advertiser - `geoLocation` ListingsV1GeoLocation — Encapsulates the details of a geo location, long/lat - `latitude` number, double, nullable — Latitude of the property - `longitude` number, double, nullable — Longitude of the property - `headline` string, nullable — The short description of the property provided by the advertiser. - `inspectionDetails` ListingsV1PropertyInspections — Property Inspection(s) details - `inspections` ListingsV1Inspection[], nullable — Inspection details for the property. e.g. opening and closing times - `recurrence` 'none' | 'weekly', nullable — Gets or Sets Recurrence - `openingDateTime` string, date-time, nullable — Opening date and time of the inspection. e.g. 2015-01-01T12:00:00. Not provided by bulk uploaded listings, in these cases refer to the inspection description field. DateTime is in a local timezone. - `closingDateTime` string, date-time, nullable — Closing date and time of the inspection. e.g. 2015-01-01T12:00:00 Not provided by bulk uploaded listings, in these cases refer to the inspection description field. DateTime is in a local timezone. - `description` string, nullable — Description of the inspection provided by the Advertiser. When listings are bulk uploaded, inspection times are provided as a string. Other inspection details will not be provided - `pastInspections` ListingsV1Inspection[], nullable — Inspection details for the property. e.g. opening and closing times - `recurrence` 'none' | 'weekly', nullable — Gets or Sets Recurrence - `openingDateTime` string, date-time, nullable — Opening date and time of the inspection. e.g. 2015-01-01T12:00:00. Not provided by bulk uploaded listings, in these cases refer to the inspection description field. DateTime is in a local timezone. - `closingDateTime` string, date-time, nullable — Closing date and time of the inspection. e.g. 2015-01-01T12:00:00 Not provided by bulk uploaded listings, in these cases refer to the inspection description field. DateTime is in a local timezone. - `description` string, nullable — Description of the inspection provided by the Advertiser. When listings are bulk uploaded, inspection times are provided as a string. Other inspection details will not be provided - `isByAppointmentOnly` boolean, nullable — True or False indicating whether the inspection is by appointment only - `isNewDevelopment` boolean, nullable — Indicates whether the property is a new development - `landArea` string, nullable — The land area display string for the property e.g. 160 sqm - `landAreaSqm` number, double, nullable — The properties land area in square meters - `media` ListingsV1ListingMedia[], nullable — The media associated with the property provided by the advertiser - `category` 'image' | 'video' | 'others', nullable — Gets or Sets Category - `type` 'photo' | 'mp4' | 'youtube' | 'floorplan' | 'vimeo' | 'notSpecified', nullable — Gets or Sets Type - `url` string, required — The URL to the property media - `priceDetails` ListingsV1PriceDetails — Encapsulates a listing's price information - `gstOption` 'na' | 'inc' | 'ex', nullable — Gets or Sets GstOption - `priceType` 'gross' | 'net', nullable — Gets or Sets PriceType - `priceUnit` 'totalAmount' | 'perSqm', nullable — Gets or Sets PriceUnit - `price` number, double, nullable — Price of the property - `priceFrom` integer, nullable — Price starting range of the property - `priceTo` integer, nullable — Upper price range of the property - `pricePrefix` string, nullable — Display price for the advertisement - `canDisplayPrice` boolean, nullable — Flag indicating whether the advertiser has chosen to display the property price - `hiddenReasons` string[], nullable — Reasons when price need to be hidden - `displayPrice` string, nullable — A string provided by the Advertiser representing the ByIdListingPriceQueryResult of the Listing e.g. Over $1,000,000 This should be the default price field for client to use - `bond` number, double, nullable — Rental bond - `priceReduction` boolean, nullable — Indicates if this property is under price reduction - `propertyId` string, nullable — The identifier which uniquely identifies the property being advertised. This may be empty if the Address of property is poorly described - `propertyTypes` string[], required — Types of the property - `providerDetails` ListingsV1ProviderDetails — Information for the listing provider. e.g. bulkuploader information - `providerSystem` string, nullable — Feed provider ID - `providerAdID` string, nullable — Unique ID within provider system - `rentalDetails` ListingsV1RentalDetails — The rental detail's of the listing in case of it being for rent or leased - `rentalMethod` 'notStated' | 'rent' | 'share' | 'holiday' | 'lease', nullable — Gets or Sets RentalMethod - `source` 'internal' | 'external', nullable — Gets or Sets Source - `leasedDate` string, date-time, nullable — The Date the listing was leased. DateTime is in a local timezone. - `leasedPrice` integer, nullable — The last leased price entered by the Advertiser This price will only be visible if allowed by the Advertiser and the listing as been leased - `canDisplayPrice` boolean, nullable — Indicates whether this instance can display price - `leasedMonths` integer, nullable — The number of months the property was last leased for This will only be visible if the property has been leased - `termOfLeaseFrom` integer, nullable — Lease term range from - `termOfLeaseTo` integer, nullable — Lease term range to - `leaseOutgoings` integer, nullable — Outgoing cost of current lease - `saleDetails` ListingsV1SaleDetails — The sale detail's of the listing in case of it being for sale or sold - `saleMethod` 'notStated' | 'auction' | 'privateTreaty' | 'tender' | 'expressionOfInterest', nullable — Gets or Sets SaleMethod - `soldDetails` ListingsV1SoldDetails — Sold details in the case of the listing being sold. - `soldAction` 'notStated' | 'auction' | 'privateTreaty' | 'withdrawn' | 'soldPriorToAuction', nullable — Gets or Sets SoldAction - `source` 'internal' | 'external', nullable — Gets or Sets Source - `soldPrice` integer, nullable — The last sold price entered by the Advertiser. This price will only be visible if allowed by the Advertiser and the listing as been sold - `governmentRecordedSoldPrice` integer, nullable — The government recorded sold price sourced from APM - `soldDate` string, date-time, nullable — The Date the listing was sold. DateTime is in a local timezone. - `canDisplayPrice` boolean, nullable — Indicates whether this instance can display price - `auctionDetails` ListingsV1AuctionDetails — The detail's of the auction in case of a listing for sale being auctioned or sold by auction - `auctionSchedule` ListingsV1AuctionSchedule — Encapsulates the details of a Property being Auctioned. - `locationDescription` string, nullable — Description and location of the auction provided by advertiser - `openingDateTime` string, date-time, nullable — Opening date and time of the auction. e.g. 2015-01-01T12:00:00 DateTime is in a local timezone. - `terms` string, nullable — Terms of the auction - `url` string, nullable — On-line URL of the auction - `auctionedPrice` integer, nullable — The auctioned price entered by the Advertiser. This price will only be visible if allowed by the Advertiser and the listing as been auctioned - `auctionedDate` string, date-time, nullable — The listing's last auctioned date and time specified by the Advertiser. This will only be visible if the listing has been auctioned. DateTime is in a local timezone. - `tenderDetails` ListingsV1TenderDetails — Tender details - `tenderRecipientName` string, nullable — Tender recipient name - `tenderAddress` string, nullable — Tender address - `tenderEndDate` string, date-time, nullable — Tender closing date. DateTime is in a local timezone. - `tenantDetails` ListingsV1TenantDetails — Tenant Details - `leaseDateVariable` boolean, nullable — Is tenant lease date variable - `leaseOptions` string, nullable — Leasing options available to a prospective tenant - `tenantInfoTermOfLeaseFrom` integer, nullable — The from range of the tenant's current lease - `tenantInfoTermOfLeaseTo` integer, nullable — The to range of the tenant's current lease - `tenantName` string, nullable — Name of the current tenant of the property - `tenantRentDetails` string, nullable — Information regarding current rental - `leaseStartDate` string, date-time, nullable — The date on which the tenants lease began, or is due to begin. DateTime is in a local timezone. - `leaseEndDate` string, date-time, nullable — The date on which the tenants lease is due to end. DateTime is in a local timezone. - `annualReturn` integer, nullable — Integer value of percentage return on this property or business - `saleTerms` string, nullable — Information relating to aspects of the sale, such as required deposit, settlement time - `isWithdrawn` boolean, nullable — Indicates if the property has been withdrawn from the market The value will be 'true' When a listing is taken off market without being sold or leased. - `seoUrl` string, nullable — Listing SEO URL - `virtualTourUrl` string, nullable — The Listing's Virtual Tour URL. - `homepassEnabled` boolean, nullable — If Homepass is enabled for the listing (agency) - `statementOfInformation` ListingsV1StatementOfInformation — Statement of Information Regarding sale listing - `estimatedPrice` ListingsV1BasicPrice — Basic price information - `from` integer, nullable — Lowest price the property is expected to sell/rent for to set search price. - `to` integer, nullable — Highest price the property is expected to sell/rent for to set search price. - `comparableData` ListingsV1ComparableData — Information regarding the past comparable property sales that influenced the setting of the estimation price - `comparableProperty` ListingsV1PastSaleData[], nullable — Comparable properties that are of a similar standard or condition to the property for sale - `unitNumber` string, nullable — Property unit number - `streetNumber` string, nullable — Property street number - `street` string, nullable — Property Street name - `suburb` string, nullable — Property suburb name - `postcode` string, nullable — Property postcode - `state` string, nullable — Property state - `displayAddress` string, nullable — display formatted address - `dateOfSale` string, nullable — Registered date of the sale - `soldPrice` integer, nullable — Property sold price - `declarationText` string, nullable — Text description if there are less than three comparable sales available - `suburbMedianPrice` ListingsV1MedianPriceData — Information regarding median house/unit price for the suburb - `priceType` 'house' | 'apartmentUnitFlat' | 'vacantLand', nullable — Gets or Sets PriceType - `suburb` string, nullable — Name of the suburb median price is based on. - `postcode` string, nullable — Postcode of the suburb - `medianPrice` integer, nullable — Median price for the suburb. - `source` string, nullable — Where median price data comes from - `sourceDateFrom` string, nullable — Start date of the median price source time period - `sourceDateTo` string, nullable — End date of the median price source time period - `sourceCollectionDate` string, nullable — The collection date of the median price source - `documentationUrl` string, nullable — Link to the statement of information documentation file - `numberOfDwellings` integer, nullable — Number of dwellings for current listing - `highlights` string[], nullable — Highlight items for the listing ## Other responses - `default` — 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)