servicearea#create

Message

service area created

Payload Example(s) (generated)

{
  "topic": "realestate/servicearea#create",
  "data": {
    "type": "CreateAction",
    "object": {
      "type": "ServiceArea",
      "kind": "PostalCode",
      "identifier": {
        "bhhsESAId": "string"
      },
      "addressLocality": "Woodland Hills",
      "postalCode": "91371",
      "addressRegion": "CA",
      "addressCountry": "US",
      "addressCounty": "Los Angeles",
      "provider": {
        "type": "RealEstateOrganization",
        "id": "https://org.example.com/profile/card#me"
      },
      "additionalProperty": {
        "relocationOffice": {
          "type": "RealEstateOffice",
          "id": "https://org.example.com/profile/card#me"
        },
        "weight": 0,
        "officeInPostalCode": true,
        "sortOrder": 0,
        "sentToConsumerSite": true,
        "sentToCompanyLocator": true,
        "sentToReferralSolutions": true,
        "luxuryPriceMinimum": {
          "type": "PriceSpecification",
          "price": 1000000,
          "priceCurrency": "USD"
        }
      }
    }
  }
}

Payload

NameTypeDescription
(root)object-
topicstringconst ("realestate/servicearea#create")
dataobject-
data.typestringconst ("CreateAction")
data.objectobjectan area when a provider provides a service. additional information available; see Using Service Areas
data.object.typestringallowed ("ServiceArea") "ServiceArea"
data.object.kindstringallowed ("City", "PostalCode") ServiceArea sub-type. City or PostalCode
data.object.identifierobjectvendor namespaced item identifiers, value should be stored and included in any future events that reference the same item.
data.object.identifier.bhhsESAIdstringBHHS internal ESA ID
data.object.addressLocalitystringCity, Township.
data.object.postalCodestringZip/Post Code
data.object.addressRegionstringState or Province.
data.object.addressCountrystringThe country. For example, USA. You can also provide the two-letter ISO 3166-1 alpha-2 country code.
data.object.addressCountystringthe county (us real estate extension)
data.object.providerobjecta broker or company who provides service in the ServiceArea
data.object.provider.typestringallowed ("RealEstateOrganization") "RealEstateOrganization"
data.object.provider.idstringprofile URI
data.object.additionalPropertyobjectBHHS specific ServiceArea properties
data.object.additionalProperty.relocationOfficeobjectrelocation office
data.object.additionalProperty.relocationOffice.typestringallowed ("RealEstateOffice") The item type (Linked-Data @type)
data.object.additionalProperty.relocationOffice.idstring-
data.object.additionalProperty.weightintegerweight
data.object.additionalProperty.officeInPostalCodebooleantrue if the service area provider is physically located in the ServiceArea.
data.object.additionalProperty.sortOrderintegersort order
data.object.additionalProperty.sentToConsumerSitebooleansent to consumer site
data.object.additionalProperty.sentToCompanyLocatorbooleansent to company locator
data.object.additionalProperty.sentToReferralSolutionsbooleansent to referral solutions
data.object.additionalProperty.luxuryPriceMinimumobjectminimum price for a property listing in the area to be considered a luxury property

Headers

NameTypeDescription
(root)object-
timestringdate & time the event was produced format (date-time)
agentstringif you are a multi-tenant app, then the agent is the user associated with the event data. any future events related to this message will be sent to the same agent/recipient format (uri)
instrumentstringthe app or service that produced the event on behalf of the agent/user format (uri)
sourcestringa copy of the event was sent to the source(s). format (uri)
originalRecipientstringthe originalRecipient helps you determine the subscription that delivered the event to you. if the originalRecipient is the same as the agent, then the you are subscribed to the agent. if the originalRecipient is different from the agent, then you are subscribed to the event source format (uri)
idstringthe Event ID (aka "Publish ID") is the immutable canonical identifier for the event. it is a URI that is unique to the event and will not change. all subscribers will receive the same id for the same event. format (uri)
@idstringformat (uri)

Tools