profile#update

Message

an agent, office or organization profile was updated

Payload Example(s) (generated)

{
  "topic": "realestate/profile#update",
  "data": {
    "type": "UpdateAction",
    "object": {
      "type": "RealEstateAgent",
      "additionalName": "Johnny,John",
      "address": {
        "type": "PostalAddress",
        "name": "Home",
        "addressCountry": "USA",
        "addressCounty": "Gotham County",
        "addressLocality": "Gotham City",
        "addressRegion": "New Jersey",
        "addressSubdivision": "Gotham Heights",
        "postalCode": "10010",
        "postOfficeBoxNumber": "Box 1234",
        "streetAddress": "1007 Mountain Gate Rd"
      },
      "certification": {
        "type": "Certification",
        "name": "e-Agent Certified",
        "issuedBy": {
          "type": "RealEstateOrganization",
          "id": "https://example.com/profile/card#me",
          "name": "Gotham City Real Estate"
        },
        "issuedTo": {
          "type": "RealEstateAgent",
          "id": "http://example.com",
          "name": "string"
        }
      },
      "contactPoint": {
        "type": "ContactPoint",
        "name": "Work",
        "telephone": "555-555-5555",
        "faxNumber": "555-555-5555",
        "email": "bob@example.com",
        "url": "https://www.facebook.com/hallandoates"
      },
      "email": "user@example.com",
      "familyName": "Smith",
      "givenName": "John",
      "id": "http://example.com",
      "identifier": {
        "bhhsconsumerid": "12345"
      },
      "image": [
        {
          "type": "ImageObject",
          "@id": "http://example.com",
          "id": "http://user.example.com/public/logo/image.jpg",
          "name": "image.jpg",
          "encodingFormat": "image/jpeg",
          "about": "http://user.example.com/profile/card#me",
          "url": "http://user.example.com/public/profile/image.jpg"
        }
      ],
      "jobTitle": [
        "CEO"
      ],
      "memberOf": [
        {
          "type": "OrganizationRole",
          "roleName": "Owner",
          "memberOf": {
            "type": "RealEstateOrganization",
            "id": "http://orgid.example.com/profile/card#me"
          },
          "member": "https://memberid.example.com/profile/card#me",
          "startDate": "2019-08-24T14:15:22Z",
          "endDate": "2019-08-24T14:15:22Z"
        }
      ],
      "name": "string",
      "parentOrganization": [
        "http://example.com"
      ],
      "permit": {
        "type": "Permit",
        "name": "DRE Number",
        "issuedBy": {
          "type": "State",
          "name": "California"
        },
        "issuedThrough": {
          "type": "Service",
          "name": "Department of Real Estate"
        },
        "validIn": {},
        "validFrom": "2019-08-24T14:15:22Z",
        "validUntil": "2019-08-24T14:15:22Z"
      },
      "subOrganization": [
        "http://example.com"
      ],
      "url": "http://example.com"
    }
  }
}

Payload

NameTypeDescription
(root)object-
topicstringconst ("realestate/profile#update")
dataobject-
data.typestringconst ("UpdateAction")
data.objectoneOf-
data.object.0 (oneOf item)objectA real estate agent who represents buyers and sellers
data.object.0.typestringconst ("RealEstateAgent")
data.object.0.additionalNamestringany other name(s) associated with the entity, i.e. nickname, middle name, maiden name, etc. For multiple names, use a comma without space as a separator.
data.object.0.addressobjectA physical address.
data.object.0.certificationobjectA certification issued by an organization to an individual or business.
data.object.0.certification.typestringallowed ("Certification") Certification
data.object.0.certification.namestringthe name of the Certification
data.object.0.certification.issuedByobjectthe issuing authority
data.object.0.certification.issuedBy.typestringallowed ("RealEstateOrganization") The item type (Linked-Data @type)
data.object.0.certification.issuedBy.idstringLinked-Data URI (@id) format (uri)
data.object.0.certification.issuedBy.namestringname of the issuing organization
data.object.0.certification.issuedToobjectthe subject
data.object.0.certification.issuedTo.typestringallowed ("RealEstateAgent") The item type (Linked-Data @type)
data.object.0.certification.issuedTo.idstringLinked-Data URI (@id) format (uri)
data.object.0.certification.issuedTo.namestring-
data.object.0.contactPointobjectA point of contact for the entity. By convention in the real estate domain, ContactPoints are preferred over telephone, email, and faxNumber so the ContactPoint.name property can be used to label values for example, Work Telephone, Home, as named contactPoint values. >= 3 properties
data.object.0.contactPoint.typestringconst ("ContactPoint")
data.object.0.contactPoint.namestringa label for the contactPoint, i.e. 'Work', or 'Home'
data.object.0.contactPoint.telephonestring-
data.object.0.contactPoint.faxNumberstring-
data.object.0.contactPoint.emailstringan email address for the item. format (email)
data.object.0.contactPoint.urlstringprimary URL for the item. format (uri)
data.object.0.emailstringa valid email address format (email)
data.object.0.familyNamestringLast Name of a person. Family Name <= 50 characters
data.object.0.givenNamestringFirst Name of a person
data.object.0.idstringLinked-Data URI (@id) format (uri)
data.object.0.identifierobject1 properties
data.object.0.imagetuple<object allOf, ...optional<any>>an ImageObject or URI reference to an image on the web.
data.object.0.image.0 (index)object allOf-
data.object.0.image.0.0 (allOf item)allOfan image, video or document availble for download
data.object.0.image.0.0.0 (allOf item)object-
data.object.0.image.0.0.0.typestringThe item type (Linked-Data @type) pattern (^[A-Z][a-zA-Z0-9]+$)
data.object.0.image.0.0.0.@idstringthe liked data uri for the Thing format (uri)
data.object.0.image.0.0.0 (property names)-pattern (^[a-z@$][a-zA-Z0-9-_]+$)
data.object.0.image.0.0.1 (allOf item)--
data.object.0.image.0.0.1.typestringallowed ("MediaObject", "ImageObject", "DigitalDocument")
data.object.0.image.0.0.1.idstringthe URL to access the item. format (uri)
data.object.0.image.0.0.1.namestringthe file name of the object.
data.object.0.image.0.0.1.encodingFormatstringMIME type
data.object.0.image.0.0.1.aboutstringURI to the subject of the image or logo format (uri)
data.object.0.image.0.0.1.urlstringURL of the image content format (uri)
data.object.0.image.0.1 (allOf item)--
data.object.0.image.0.1.typestringallowed ("ImageObject")
data.object.0.image.0.1.idany-
data.object.0.image.0.1.nameany-
data.object.0.image.0.1.encodingFormatany-
data.object.0.jobTitlearray<string>-
data.object.0.jobTitle (single item)stringThe job title of the person (for example, Financial Manager).
data.object.0.memberOfarray<anyOf>an Organization (or ProgramMembership) to which this Person or Organization belongs.
data.object.0.memberOf (single item)anyOf-
data.object.0.memberOf.0 (anyOf item)objectdescribes a role played by a member and a group or organization.
data.object.0.memberOf.0.typestringallowed ("OrganizationRole") a role played by the member in the memberOf group
data.object.0.memberOf.0.roleNamestringthe role name
data.object.0.memberOf.0.memberOfobjectthe org or group where the role is performed
data.object.0.memberOf.0.memberstringmember object or id format (uri)
data.object.0.memberOf.0.startDatestringdate the member began performing this role format (date-time)
data.object.0.memberOf.0.endDatestringdate the member stopped performing the role format (date-time)
data.object.0.memberOf.1 (anyOf item)stringformat (uri)
data.object.0.namestring-
data.object.0.parentOrganizationarray<string>organizations of which this org is a part.
data.object.0.parentOrganization (single item)stringformat (uri)
data.object.0.permitobjectA permit issued by an organization to an individual or business.
data.object.0.permit.typestringallowed ("Permit") Permit type.
data.object.0.permit.namestringCommon or display value of the Permit.
data.object.0.permit.issuedByobjectThe issuing authority
data.object.0.permit.issuedThroughobjectthe service through which the permit was granted
data.object.0.permit.validInobject-
data.object.0.permit.validFromstringstart date format (date-time)
data.object.0.permit.validUntilstringend date format (date-time)
data.object.0.subOrganizationarray<string>child organizations of the organization
data.object.0.subOrganization (single item)stringformat (uri)
data.object.0.urlstringURL of the item. format (uri)
data.object.1 (oneOf item)allOf-
data.object.1.0 (allOf item)--
data.object.1.0.idstring-
data.object.1.1 (allOf item)object-
data.object.1.1.typestring-
data.object.1.1.addressobjectA physical address.
data.object.1.1.address.typestringconst ("PostalAddress")
data.object.1.1.address.streetAddressstringthe street address <= 75 characters
data.object.1.1.address.postOfficeBoxNumberstringThe post office box number for PO box addresses.
data.object.1.1.address.addressRegionstringabbreviated state or province
data.object.1.1.address.addressLocalitystringCity, Township. <= 50 characters
data.object.1.1.address.postalCodestringZip/Post Code <= 12 characters
data.object.1.1.address.addressCountrystringallowed ("CA", "DE", "GR", "IN", "IT", "MX", "PE", "PT", "ES", "AE", "GB", "US") two-letter ISO 3166-1 alpha-2 country code
data.object.1.1.address.addressCountystringCounty
data.object.1.1.address.addressSubdivisionstringthe subdivision or neighborhood (us real estate extension)
data.object.1.1.availableLanguagearray<object>Please use one of the language codes from the IETF BCP 47 standard.
data.object.1.1.availableLanguage.typestringconst ("Language")
data.object.1.1.availableLanguage.namestringthe display name of the language
data.object.1.1.availableLanguage.additionalNamestringBCP 47 language code
data.object.1.1.branchCodestringA short textual code that uniquely identifies a place of business.
data.object.1.1.certificationtuple<object, ...optional<any>>certifications granted to a person or organization
data.object.1.1.certification.0 (index)objectA certification issued by an organization to an individual or business.
data.object.1.1.certification.0.typestringallowed ("Certification") Certification
data.object.1.1.certification.0.namestringthe name of the Certification
data.object.1.1.certification.0.issuedByobjectthe issuing authority
data.object.1.1.certification.0.issuedBy.typestringallowed ("RealEstateOrganization") The item type (Linked-Data @type)
data.object.1.1.certification.0.issuedBy.idstringLinked-Data URI (@id) format (uri)
data.object.1.1.certification.0.issuedBy.namestringname of the issuing organization
data.object.1.1.certification.0.issuedToobjectthe subject
data.object.1.1.certification.0.issuedTo.typestringallowed ("RealEstateAgent") The item type (Linked-Data @type)
data.object.1.1.certification.0.issuedTo.idstringLinked-Data URI (@id) format (uri)
data.object.1.1.certification.0.issuedTo.namestring-
data.object.1.1.contactPointarray<object>a named point of contact - telephone, email, faxNumber, and/or url for the entity
data.object.1.1.contactPoint.typestringconst ("ContactPoint")
data.object.1.1.contactPoint.namestringa label for the contactPoint, i.e. 'Work', or 'Home'
data.object.1.1.contactPoint.telephonestring-
data.object.1.1.contactPoint.faxNumberstring-
data.object.1.1.contactPoint.emailstringan email address for the item. format (email)
data.object.1.1.contactPoint.urlstringprimary URL for the item. format (uri)
data.object.1.1.emailstringa valid email address format (email)
data.object.1.1.faxNumberstringDo people still use fax machines?
data.object.1.1.imagetuple<object allOf, ...optional<any>>an ImageObject or URI reference to an image on the web.
data.object.1.1.image.0 (index)object allOf-
data.object.1.1.image.0.0 (allOf item)allOfan image, video or document availble for download
data.object.1.1.image.0.0.0 (allOf item)object-
data.object.1.1.image.0.0.0.typestringThe item type (Linked-Data @type) pattern (^[A-Z][a-zA-Z0-9]+$)
data.object.1.1.image.0.0.0.@idstringthe liked data uri for the Thing format (uri)
data.object.1.1.image.0.0.0 (property names)-pattern (^[a-z@$][a-zA-Z0-9-_]+$)
data.object.1.1.image.0.0.1 (allOf item)--
data.object.1.1.image.0.0.1.typestringallowed ("MediaObject", "ImageObject", "DigitalDocument")
data.object.1.1.image.0.0.1.idstringthe URL to access the item. format (uri)
data.object.1.1.image.0.0.1.namestringthe file name of the object.
data.object.1.1.image.0.0.1.encodingFormatstringMIME type
data.object.1.1.image.0.0.1.aboutstringURI to the subject of the image or logo format (uri)
data.object.1.1.image.0.0.1.urlstringURL of the image content format (uri)
data.object.1.1.image.0.1 (allOf item)--
data.object.1.1.image.0.1.typestringallowed ("ImageObject")
data.object.1.1.image.0.1.idany-
data.object.1.1.image.0.1.nameany-
data.object.1.1.image.0.1.encodingFormatany-
data.object.1.1.logoarray<object>-
data.object.1.1.logo.typestringallowed ("DigitalDocument")
data.object.1.1.logo.idstring-
data.object.1.1.logo.namestringdocument name or title
data.object.1.1.logo.encodingFormatstringISO Media Type
data.object.1.1.logo.aboutobjectsubject of the Document
data.object.1.1.logo.urlstringpublic URL of the object
data.object.1.1.namestring-
data.object.1.1.parentOrganizationarray<string>organizations of which this org is a part.
data.object.1.1.parentOrganization (single item)stringformat (uri)
data.object.1.1.subOrganizationarray<string>child organizations of the organization
data.object.1.1.subOrganization (single item)stringformat (uri)
data.object.1.1.telephonestringPrimary phone number.
data.object.1.1.urlstringURL of the item. format (uri)
data.object.1.2 (allOf item)-A real estate team.
data.object.1.2.typestringallowed ("RealEstateTeam") RealEstateTeam
data.object.1.2.areaServedobjectthe physical areas that make up the ServiceArea
data.object.1.2.descriptionstringdescription of the item.
data.object.1.2.parentOrganizationarray<string>A franchisor or affiliate network of which this organization plays a membership role.
data.object.1.2.parentOrganization (single item)stringformat (uri)
data.object.1.2.memberarray<allOf>-
data.object.1.2.member (single item)allOf-
data.object.1.2.member.0 (allOf item)objectdescribes a role played by a member and a group or organization.
data.object.1.2.member.0.typestringallowed ("OrganizationRole") a role played by the member in the memberOf group
data.object.1.2.member.0.roleNamestringthe role name
data.object.1.2.member.0.memberOfobjectthe org or group where the role is performed
data.object.1.2.member.0.memberstringmember object or id format (uri)
data.object.1.2.member.0.startDatestringdate the member began performing this role format (date-time)
data.object.1.2.member.0.endDatestringdate the member stopped performing the role format (date-time)
data.object.1.2.member.1 (allOf item)objecta membership relationship. Subclass of OrganizationRole
data.object.1.2.member.1.typestringallowed ("RealEstateTeamMembership") a member of a real estate team
data.object.1.2.member.1.roleNamestringallowed ("TeamMember", "TeamAdmin", "TeamOwner")
data.object.1.2.member.1.memberOfstringformat (uri)
data.object.1.2.member.1.memberstringformat (uri)
data.object.2 (oneOf item)allOf-
data.object.2.0 (allOf item)object-
data.object.2.0.typestring-
data.object.2.0.addressobjectA physical address.
data.object.2.0.address.typestringconst ("PostalAddress")
data.object.2.0.address.streetAddressstringthe street address <= 75 characters
data.object.2.0.address.postOfficeBoxNumberstringThe post office box number for PO box addresses.
data.object.2.0.address.addressRegionstringabbreviated state or province
data.object.2.0.address.addressLocalitystringCity, Township. <= 50 characters
data.object.2.0.address.postalCodestringZip/Post Code <= 12 characters
data.object.2.0.address.addressCountrystringallowed ("CA", "DE", "GR", "IN", "IT", "MX", "PE", "PT", "ES", "AE", "GB", "US") two-letter ISO 3166-1 alpha-2 country code
data.object.2.0.address.addressCountystringCounty
data.object.2.0.address.addressSubdivisionstringthe subdivision or neighborhood (us real estate extension)
data.object.2.0.availableLanguagearray<object>Please use one of the language codes from the IETF BCP 47 standard.
data.object.2.0.availableLanguage.typestringconst ("Language")
data.object.2.0.availableLanguage.namestringthe display name of the language
data.object.2.0.availableLanguage.additionalNamestringBCP 47 language code
data.object.2.0.branchCodestringA short textual code that uniquely identifies a place of business.
data.object.2.0.certificationtuple<object, ...optional<any>>certifications granted to a person or organization
data.object.2.0.certification.0 (index)objectA certification issued by an organization to an individual or business.
data.object.2.0.certification.0.typestringallowed ("Certification") Certification
data.object.2.0.certification.0.namestringthe name of the Certification
data.object.2.0.certification.0.issuedByobjectthe issuing authority
data.object.2.0.certification.0.issuedBy.typestringallowed ("RealEstateOrganization") The item type (Linked-Data @type)
data.object.2.0.certification.0.issuedBy.idstringLinked-Data URI (@id) format (uri)
data.object.2.0.certification.0.issuedBy.namestringname of the issuing organization
data.object.2.0.certification.0.issuedToobjectthe subject
data.object.2.0.certification.0.issuedTo.typestringallowed ("RealEstateAgent") The item type (Linked-Data @type)
data.object.2.0.certification.0.issuedTo.idstringLinked-Data URI (@id) format (uri)
data.object.2.0.certification.0.issuedTo.namestring-
data.object.2.0.contactPointarray<object>a named point of contact - telephone, email, faxNumber, and/or url for the entity
data.object.2.0.contactPoint.typestringconst ("ContactPoint")
data.object.2.0.contactPoint.namestringa label for the contactPoint, i.e. 'Work', or 'Home'
data.object.2.0.contactPoint.telephonestring-
data.object.2.0.contactPoint.faxNumberstring-
data.object.2.0.contactPoint.emailstringan email address for the item. format (email)
data.object.2.0.contactPoint.urlstringprimary URL for the item. format (uri)
data.object.2.0.emailstringa valid email address format (email)
data.object.2.0.faxNumberstringDo people still use fax machines?
data.object.2.0.imagetuple<object allOf, ...optional<any>>an ImageObject or URI reference to an image on the web.
data.object.2.0.image.0 (index)object allOf-
data.object.2.0.image.0.0 (allOf item)allOfan image, video or document availble for download
data.object.2.0.image.0.0.0 (allOf item)object-
data.object.2.0.image.0.0.0.typestringThe item type (Linked-Data @type) pattern (^[A-Z][a-zA-Z0-9]+$)
data.object.2.0.image.0.0.0.@idstringthe liked data uri for the Thing format (uri)
data.object.2.0.image.0.0.0 (property names)-pattern (^[a-z@$][a-zA-Z0-9-_]+$)
data.object.2.0.image.0.0.1 (allOf item)--
data.object.2.0.image.0.0.1.typestringallowed ("MediaObject", "ImageObject", "DigitalDocument")
data.object.2.0.image.0.0.1.idstringthe URL to access the item. format (uri)
data.object.2.0.image.0.0.1.namestringthe file name of the object.
data.object.2.0.image.0.0.1.encodingFormatstringMIME type
data.object.2.0.image.0.0.1.aboutstringURI to the subject of the image or logo format (uri)
data.object.2.0.image.0.0.1.urlstringURL of the image content format (uri)
data.object.2.0.image.0.1 (allOf item)--
data.object.2.0.image.0.1.typestringallowed ("ImageObject")
data.object.2.0.image.0.1.idany-
data.object.2.0.image.0.1.nameany-
data.object.2.0.image.0.1.encodingFormatany-
data.object.2.0.logoarray<object>-
data.object.2.0.logo.typestringallowed ("DigitalDocument")
data.object.2.0.logo.idstring-
data.object.2.0.logo.namestringdocument name or title
data.object.2.0.logo.encodingFormatstringISO Media Type
data.object.2.0.logo.aboutobjectsubject of the Document
data.object.2.0.logo.urlstringpublic URL of the object
data.object.2.0.namestring-
data.object.2.0.parentOrganizationarray<string>organizations of which this org is a part.
data.object.2.0.parentOrganization (single item)stringformat (uri)
data.object.2.0.subOrganizationarray<string>child organizations of the organization
data.object.2.0.subOrganization (single item)stringformat (uri)
data.object.2.0.telephonestringPrimary phone number.
data.object.2.0.urlstringURL of the item. format (uri)
data.object.2.1 (allOf item)-A real estate franchisor, broker or business
data.object.2.1.typestringallowed ("RealEstateOrganization", "RealEstateOffice")
data.object.2.1.areaServedobjectthe physical areas that make up the ServiceArea
data.object.2.1.descriptionstringdescription of the item.
data.object.2.1.parentOrganizationarray<string>organizations of which this org is a part.
data.object.2.1.parentOrganization (single item)stringformat (uri)
data.object.2.1.numberOfSubOrganizationsnumberthe number of offices for an affiliate.
data.object.2.1.memberarray<anyOf>A member of an Organization or a ProgramMembership. Organizations can be members of organizations; ProgramMembership is typically for individuals.
data.object.2.1.member (single item)anyOf-
data.object.2.1.member.0 (anyOf item)objectdescribes a role played by a member and a group or organization.
data.object.2.1.member.0.typestringallowed ("OrganizationRole") a role played by the member in the memberOf group
data.object.2.1.member.0.roleNamestringthe role name
data.object.2.1.member.0.memberOfobjectthe org or group where the role is performed
data.object.2.1.member.0.memberstringmember object or id format (uri)
data.object.2.1.member.0.startDatestringdate the member began performing this role format (date-time)
data.object.2.1.member.0.endDatestringdate the member stopped performing the role format (date-time)
data.object.2.1.member.1 (anyOf item)stringformat (uri)
data.object.2.1.memberOfarray<anyOf>-
data.object.2.1.memberOf (single item)anyOf-
data.object.2.1.memberOf.0 (anyOf item)objectdescribes a role played by a member and a group or organization.
data.object.2.1.memberOf.0.typestringallowed ("OrganizationRole") a role played by the member in the memberOf group
data.object.2.1.memberOf.0.roleNamestringthe role name
data.object.2.1.memberOf.0.memberOfobjectthe org or group where the role is performed
data.object.2.1.memberOf.0.memberstringmember object or id format (uri)
data.object.2.1.memberOf.0.startDatestringdate the member began performing this role format (date-time)
data.object.2.1.memberOf.0.endDatestringdate the member stopped performing the role format (date-time)
data.object.2.1.memberOf.1 (anyOf item)allOf-
data.object.2.1.memberOf.1.0 (allOf item)objectdescribes a role played by a member and a group or organization.
data.object.2.1.memberOf.1.0.typestringallowed ("OrganizationRole") a role played by the member in the memberOf group
data.object.2.1.memberOf.1.0.roleNamestringthe role name
data.object.2.1.memberOf.1.0.memberOfobjectthe org or group where the role is performed
data.object.2.1.memberOf.1.0.memberstringmember object or id format (uri)
data.object.2.1.memberOf.1.0.startDatestringdate the member began performing this role format (date-time)
data.object.2.1.memberOf.1.0.endDatestringdate the member stopped performing the role format (date-time)
data.object.2.1.memberOf.1.1 (allOf item)objecta membership relationship
data.object.2.1.memberOf.1.1.typestringallowed ("MLSMembership") an MLS member relationship
data.object.2.1.memberOf.1.1.roleNamestring-
data.object.2.1.memberOf.1.1.memberOfobject-
data.object.2.1.memberOf.1.1.memberstringformat (uri)
data.object.2.1.memberOf.1.1.memberIdstringthe user's MLSID
data.object.2.1.permitarray<object>-
data.object.2.1.permit (single item)object-

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

Next
Getting started