Skip to main content

Timestamps

Property​

The Property resource contains several logical timestamps indicating when changes are made to the record. The proper use of the timestamps will minimize the amount of data you are required to replicate. Improper use will simply cost you more in time and resources. Repeated improper use may result in hard limits being imposed.

ModificationTimestamp​

This RESO Data Dictionary specified field is updated whenever the data of the Property record itself changes. This would be changes such as a status, price change or changing the amenity list. If you want to ensure all the property attribute information is up to date, use this field to pull changes.

MajorChangeTimestamp​

This Data Dictionary specified field is updated whenever certain major fields change value in the property record. This is a subset of the property data and currently includes:

  • MlsStatus
  • ListPrice
  • ListAgentKey
  • ListOfficeKey

Note that the Amplify system allows each customer to specify which fields are considered as a MajorChangeTimestamp change.

PhotosChangeTimestamp​

This Data Dictionary field is kept in the Property record to reflect changes to the photos of a listing. Note that a change to PhotosChangeTimestamp DOES NOT change the ModificationTimestamp of the property record. A change to this field simply lets you know to check the Media resource for changes to the associated photos.

DocumentsChangeTimestamp​

This Data Dictionary field is kept in the Property record to reflect changes to the documents of a listing. Note that a change to DocumentsChangeTimestamp DOES NOT change the ModificationTimestamp of the property record. A change to this field simply lets you know to check the Media resource for changes to the associated documents.

MediaChangeTimestamp​

This Amplify field is kept in the Property record to reflect changes to the media of a listing. Note that a change to MediaChangeTimestamp DOES NOT change the ModificationTimestamp of the property record. A change to this field simply lets you know to check the Media resource for changes to the media records. It gives you a single value to check if you want changes for both photos and documents.

PropertyRooms​

Changes to the PropertyRooms of a Property will be reflected in the Property.ModificationTimestamp field. You can also query rooms independently as an optimization.

ModificationTimestamp​

This RESO Data Dictionary specified field is updated whenever the data of the PropertyRoom record itself changes. This would be changes such as a status or changing the amenity list. If you want to ensure all the room attribute information is up to date, use this field to pull changes.

note

Note that the Amplify system ensures that the RoomKey of a room never changes and is never re-used. If a room is deleted from the property, then that Amplify record will have its RoomStatus value changed to Deleted. It is a soft delete to help determine the set of changes needed without replacing all data.

Media​

Changes to media records will cause the media related Property timestamps to update as indicated above.

ModificationTimestamp​

This RESO Data Dictionary specified field is updated whenever a media record is changed.

MediaModificationTimestamp​

This RESO Data Dictionary specified field is updated whenever a media record is changed.

note

Note that the Amplify systems that the MediaKey never changes and is never re-used. It a media record is deleted, then the MediaStatus value is changed to Deleted. It is a soft delete to help determine the set of changes needed without replacing all the data.

note

Data Dictionary notes a possible difference in behavior between ModificationTimestamp and MediaModificationTimestamp. Nominally this is to distinguish between a change in the photo/document binary versus a change to a description about one. In practice, changes to one without the other are rare. Amplify will update both values on any change to the media record.