--- title: "Creates or updates a business listing" method: PUT path: "/v1/listings/business" tags: ["Listings"] --- # Creates or updates a business listing `PUT /v1/listings/business` ## Request body - DomainListingAdminServiceV1ModelBusinessListing — Business Listing - `listingAction` 'sale' | 'rent' | 'saleAndLease' — Sale or Rent - `contactPreference` 'byPhone' — Indicates the listing preferred contact method. Default by both phone and email if not provided. - `underOfferOrContract` boolean — Set for Sale listings only - `nabers` number, double — The NABERS Rating is the energy efficiency rating that the property has been measured to have. This rating is measured in increments of .5 and can range from 0 to 6. The NABERS rating is required for spaces within office buildings of 1000 square metres or more. For more information on the NABERS rating system please visit http://www.nabers.gov.au - `propertyDetails` DomainListingAdminServiceV1ModelBusinessProperty — Business Property - `propertyType` string[] — Business property types ['accessoriesParts', 'accommodationTourism', 'accounting', 'adult', 'advertisingMarketing', 'aerial', 'aeronautical', 'agedCare', 'agricultural', 'air', 'aircraft', 'alarms', 'alcoholLiquor', 'amusements', 'animalRelated', 'aquaculture', 'aquaticMarineMarinaBerth', 'artsCrafts', 'autoElectrical', 'automotive', 'backpackerHostel', 'bakery', 'barsNightclubs', 'beautyHealth', 'beautyProducts', 'beautySalon', 'bikeAndMotorcycle', 'boardingKennels', 'boatsMarineMarinaBerth', 'bookkeeping', 'brokerage', 'builder', 'buildingAndConstruction', 'bus', 'butcher', 'cafeCoffeeShop', 'car', 'carBusTruck', 'carDealership', 'carRental', 'carWash', 'caravanPark', 'carpenter', 'catering', 'childCare', 'civil', 'cleaning', 'cleaningAndMaintenance', 'clinicalPractice', 'clothingAccessories', 'clothingFootwear', 'communication', 'communications', 'computerIT', 'computerAndInternet', 'construction', 'convenienceStore', 'copyLaminate', 'courier', 'cropHarvesting', 'customs', 'dairyFarming', 'deli', 'dental', 'detailing', 'distributors', 'drivingSchools', 'educationTraining', 'educational', 'electrical', 'employmentRecruitment', 'entertainment', 'entertainmentTechnology', 'export', 'farming', 'fertiliser', 'finance', 'financialServices', 'fishingForestry', 'floristNursery', 'foodBeverage', 'foodBeverageHospitality', 'franchiseBusinessOpportunities', 'freight', 'fruitVegFreshProduce', 'fruitPicking', 'functionCentre', 'furnitureTimber', 'gambling', 'gardenHousehold', 'gardenNurseries', 'gardening', 'glassCeramic', 'guestHouseBB', 'hairdresser', 'healthBeauty', 'healthSpa', 'hire', 'homeGarden', 'homeBased', 'homewareHardware', 'hospital', 'hotel', 'huntingTrap', 'import', 'importExportWholesale', 'industrialManufacturing', 'insemination', 'insurance', 'internet', 'irrigationServices', 'juiceBar', 'landClearing', 'landscaping', 'laundryDryCleaning', 'legal', 'leisureEntertainment', 'limousineTaxi', 'livestock', 'machinery', 'machineryMetal', 'managementRights', 'manufacturers', 'manufacturingEngineering', 'marine', 'massage', 'mechanicalRepair', 'media', 'medical', 'medicalPractice', 'miningEarthMoving', 'mobileServices', 'motel', 'motorcycle', 'musicRelated', 'mustering', 'nails', 'naturalTherapies', 'newsagency', 'nursery', 'nursingHome', 'officeSupplies', 'oilGas', 'panelBeating', 'paperPrinting', 'parkingCarSpace', 'pestRelated', 'pharmacies', 'plastic', 'plumbing', 'poolWater', 'postOffices', 'printPhoto', 'professional', 'propertyRealEstate', 'rail', 'recreationSport', 'recruitment', 'repair', 'resort', 'restaurant', 'retail', 'retailer', 'retirement', 'retirementVillage', 'road', 'rural', 'scientific', 'sea', 'security', 'serviceStation', 'services', 'shearing', 'sportsComplexGym', 'supermarket', 'takeawayFood', 'taxi', 'themePark', 'tours', 'training', 'transportDistribution', 'travel', 'truck', 'vending', 'water', 'welding', 'wholesale', 'wholesalers', 'woolClassing', 'wreckers', 'alcoholGrocery', 'cafeRestaurants', 'discountStore', 'ecoFriendly', 'green', 'grocery', 'specialityRetail', 'storage', 'travelAgency', 'varietyStore', 'chickenShop', 'seafoodShop', 'deliCafe', 'cropping', 'viticulture', 'grazing', 'horticulture', 'equine', 'farmlet', 'orchard', 'ruralLifestyle', 'onlineBusiness']. - `landArea` DomainListingAdminServiceV1ModelLandArea — Area information, Either single value or from and To must be provided - `unit` 'squareMetres' | 'acres' | 'hectares' | 'squareFeet' | 'squareYards' | 'squares' — Unit of measure - `value` number, double — Area. Will be rounded to 2 decimals. - `from` number, double — Minimum area - `to` number, double — Maximum area - `parking` DomainListingAdminServiceV1ModelParking — Parking Details - `parkingType` 'onSite' | 'onStreet' | 'noParking' — Can have the value \"OnSite\", \"OnStreet\", \"NoParking\". Default \"NoParking\" - `numberOnSite` integer — Number On Site - `information` string — Additional information regarding the parking condition - `pdfs` DomainListingAdminServiceV1ModelPropertyPdf[] — List of PDF files related to the listing - `type` 'commercialPdf' | 'newDevBrochurePdf' | 'floorplanPdf' | 'devProjectPdf' — Type of the PDF - `url` string — Url of the PDF - `description` string — Description of the PDF - `isMarkedForLiveability` boolean — Is the property liveability compliant - `propertyName` string — Name of the property up to 70 characters - `location` string — Short location information up to 30 character, e.g.: Greenhills Beach - `images` DomainListingAdminServiceV1ModelPropertyMedia[] — List of image files, photos or floor plans related to the listing. - `resourceType` 'photograph' | 'floorPlan' | 'video' | 'virtualTour' | 'webLink' — Type of the resource - `url` string — shows the place from where file can be downloaded - `address` DomainListingAdminServiceV1ModelAddress — Address structure for property - `displayOption` 'unspecified' | 'fullAddress' | 'streetAndSuburb' | 'suburbOnly' | 'regionOnly' | 'areaOnly' | 'stateOnly' — What granularity to display the properties location at. For residential listings, the accepted displayOption values are `FullAddress`, `StreetAndSuburb` or `SuburbOnly`. - `state` 'nsw' | 'vic' | 'act' | 'sa' | 'wa' | 'tas' | 'qld' | 'nt' — State - `unitNumber` string — Unit number for apartments, maximum 30 characters - `street` string — Street name, maximum 100 characters - `suggestedGeoLocation` DomainListingAdminServiceV1ModelGeoLocation — Contains geocoding of an address - `latitude` number, double — Latitude - `longitude` number, double — Longitude - `streetNumber` string — Street number, maximum 20 characters - `suburb` string — Suburb name , maximum 50 characters - `postcode` string — Postcode - `area` DomainListingAdminServiceV1ModelArea — Area information, Either single value or from and To must be provided - `unit` 'squareMetres' | 'acres' | 'hectares' | 'squareFeet' | 'squareYards' | 'squares' — Unit of measure, defaults to SquareMetres if not provided. - `value` number, double — Area. Will be rounded to 2 decimals. - `from` number, double — Minimum area - `to` number, double — Maximum area - `leaseHoldDetails` DomainListingAdminServiceV1ModelLeaseHoldDetail — Contains additional details about a business listing - `leaseholdRentPeriod` 'perMonth' | 'perAnnum' — Rent period for the existing lease, can be: ['perMonth', 'perAnnum'] - `leaseholdPriceUnit` 'totalAmount' | 'perSqm' — Price unit for the existing lease, can be: ['totalAmount', 'perSqm'] - `leaseholdTerm` integer — Term of existing lease - `leaseholdStart` string, date-time — Start of existing lease - `leaseholdRent` number, double — Rent amount for the existing lease - `saleInfo` DomainListingAdminServiceV1ModelSaleInfo — Contains details about a business sales info - `annualSales` number, double — Annual sales amount for the business - `annualProfit` number, double — Annual profit amount for the business - `stockValue` number, double — Stock value of the business - `freeholdCommercialAdId` integer — The ad id of the commercial property with a freehold that the business belongs to. Leasehold and freehold are mutually exclusive properties, only specify one - `price` DomainListingAdminServiceV1ModelPrice — Pricing Information - `displayText` string — When provided this will be shown instead of the price range, e.g.: \"Offers over $450K considered\" - `from` integer — Lowest price the property is expected to sell/rent for to set search price. For a fixed price, set this value the same as To - `to` integer — Highest price the property is expected to sell/rent for to set search price. For a fixed price, set this value the same as From - `domainAdId` integer — Domain Advertisement Id, not applicable for creating new ads. Mandatory when updating a listing that belongs to an agency that is in the process of being migrated between listing providers. - `domainAgencyID` integer — The Domain Agency Id number - `providerAdId` string — External Advertisement Id of up to 50 characters will be stored.<br /> This value is used to identify an Advertisement for updates and should be unique for listing provider.<br /> This value is case-insensitive (meaning AAAA will update aaaa). - `features` string — Comma-separated list of features. 1000 characters in length. Select as appropriate or write your own. INSIDE: Air conditioning, Ensuite, Floorboards, Indoor Spa, Gym, Alarm System, Intercom, Built in wardrobes, Furnished, Internal Laundry, Pets allowed, Cable or Satellite, Gas, Broadband internet access, Bath, Fireplace(s), Separate Dining Room, Heating, Dishwasher, Study. OUTSIDE: Tennis Court, Secure Parking, Shed, Fully fenced, Balcony / Deck, Garden / Courtyard, Swimming Pool, Outdoor Spa. LOCATION: Ground floor, Water Views, North Facing, City Views. ECO FRIENDLY: Double glazed windows, Energy efficient appliances, Water efficient appliances, Wall / ceiling insulation, Rainwater storage tank, Greywater system, Water efficient fixtures, Solar hot water, Solar panels - `description` string — Description of the property. 6000 characters in length. The following HTML elements are permitted: &lt;br /&gt;, &lt;p&gt;&lt;/p&gt;, &amp;nbsp;. HTML must be well-formed. Carriage Returns are interpreted as line breaks. Foreign characters must be HTML encoded, e.g., façade for façade. Unicode characters which are unsupported by Latin-1 (ISO-8859-1 range from U+0080 to U+00FF), will be removed https://en.wikipedia.org/wiki/ISO/IEC_8859-1 - `summary` string — 'Headline' Any HTML stripped out. If the Summary is less than 80 characters long then the description is concatenated to it and the total trimmed to 250 characters. - `inspectionDetails` DomainListingAdminServiceV1ModelInspectionDetails — Inspection details - `inspectionDescription` string — Free text field for inspections - `inspections` DomainListingAdminServiceV1ModelInspection[] — Inspection times of the listing - `from` string, date-time — Format: yyyy-mm-dd HH:mm:ss eg: 2015-10-20 13:30:00 - `to` string, date-time — Format: yyyy-mm-dd HH:mm:ss, eg: 2015-10-20 14:30:00 - `repeat` boolean — Specifies if the inspection is recurring weekly - `media` DomainListingAdminServiceV1ModelPropertyMedia[] — Links to VideoURL, virtual tour or weblink. Maximum length of media URLs is 255 characters. - `resourceType` 'photograph' | 'floorPlan' | 'video' | 'virtualTour' | 'webLink' — Type of the resource - `url` string — shows the place from where file can be downloaded - `contacts` DomainListingAdminServiceV1ModelContact[] — Minimum required attributes: First name, last name and E-mail. If the DomainAgentId is provided, contact information will be based on the existing agent found for that id. Otherwise first name, last name and email will be used to find the matching contact. A new contact will be created if no contact can be found. - `domainAgentId` integer — Domain ID of the contact person at the agency - `firstName` string — First name. Maximum 50 characters. - `lastName` string — Last name. Maximum 50 characters. - `phone` string — Phone. Maximum 20 characters. - `fax` string — Fax. Maximum 20 characters. - `mobile` string — Mobile. Maximum 20 characters. - `email` string — Email. Maximum 100 characters. - `receiveEmails` boolean — Indicates whether the contact person should receive emails for the listing - `otherEnquiryEmail` string — Sets an additional Email Address to which enquiries on the Listing will be sent - `receiveEmailsToDefaultAddress` boolean — Send email enquiries to the default address for this listing type - `isRural` boolean — True if the property is rural - `supplementary` DomainListingAdminServiceV1ModelListingSupplementary[] — Rural attributes *Improvements* (optional) Available `types` (fixed list, optional): * Machinery Shed * Shearing Shed * Workshop * Shearers Quarters * Silos * Other Housing * Managers Accommodation *Fencing* (optional) `description` (string, optional): free text fencing description, maximum 250 characters. *Yards* (optional) Available `types` (fixed list, optional): * Sheep * Cattle *Homestead* (optional) `description` (string, optional): description of the homestead and construction, maximum 250 characters. `metadata` (optional) * `area` (decimal, optional): homestead area in square metres. Available `types` (fixed list, optional): * Office * Ensuite * Tennis Court * Mains Gas * Floorboards * Internal Laundry *Water* (optional) `description` (string, optional): water comments, maximum 250 characters. Available `types` (fixed list, optional): * Tank * Well * Reticulated * Bores * Springs * Creeks * Dams * River *Crops* (optional) `description` (string, optional): description of the crops, maximum 250 characters. `metadata` (optional) * `croppedAnnually` (decimal, optional): average annual area cropped in hectares. * `fallowAnnually` (decimal, optional): average annual fallow area in hectares. * `pastures` (string, optional): description of pastures available, maximum 250 characters. *Livestock* (optional) `description` (string, optional): additional comments, maximum 250 characters. `metadata` (optional) * `capacity` (decimal, optional): property carrying capacity in DSE (unit of carry capacity). Available `types` (fixed list, optional): * Sheep * Pigs * Cattle * Poultry * Horses * Exotic * Goats * Stud *Inclusions* (optional) `description` (string, optional): description of plant and machinery included in sale, maximum 250 characters. `metadata` (optional) * `livestock` (string, optional): description of livestock included in sale, maximum 250 characters. * `crop` (string, optional): description of crops included in sale, maximum 250 characters. *Irrigation* (optional) `description` (string, optional): irrigation comments, maximum 250 characters `metadata` (optional) * `rainfall` (decimal, optional): annual rainfall in millimetres. - `name` string — Name - `description` string — Description - `types` string[] — Types - `metadata` DomainListingAdminServiceV1ModelSupplementaryMetadata[] — Metadata - `measurementUnit` 'squareMetres' | 'hectares' | 'millimetres' | 'dse' — Measurement unit - `name` string — Name - `description` string — Description - `measurement` number, double — Measurement ## Response `200` Ok - DomainListingAdminServiceV1ModelListingResponse — Represent the listing job. - `processStatus` 'queued' | 'processing' | 'processed' | 'searchable' | 'failed' | 'error' — Status of listing been processed - `id` string — The listing job Id. This job will eventually be processed. - `agencyId` integer — Agency Id from Domain. - `providerId` string — Provider Id for the agency. - `providerAdId` string — Listing identifier provided by CRM. - `versionId` string — Version Id ## Other responses - `202` — Accepted --- [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/24ab78aba827/schema)