Threads

Retrieve latest threads: use this method to retrieve threads that have messages created within the specified date and time, or empty threads that were created during this period.

Recommended use: call this method every 5 minutes, with “newerThan” and “olderThan” defining a 10-minute window. Longer date ranges should be used only in case of synchronization outage or initial import. Threads with messages older than 24 hours won't be retrieved.

get/api/messaging/threads/latest

Request

  • Base URL: https://api.rentalsunited.com
  • URL: https://api.rentalsunited.com/api/messaging/threads/latest
  • Auth: one of:
    • API key in header X-RU-AccessKey and API key in header X-RU-SecretKey
    • HTTP basic

Query parameters

newerThanstring date-time required

Filters threads with messages created after specific date and time. The field accepts the timestamp from the last 24-hour range (from the current time in UTC). Only threads with messages newer than this timestamp will be returned. The date must follow the YYYY-MM-DD HH:MM:SS format.

olderThanstring date-time

(optional) - Filters threads with messages created before a specific date and time. If not provided, it defaults to the current UTC time. The field accepts the timestamp from the last 24-hour range (from the current time in UTC). The date must follow the YYYY-MM-DD HH:MM:SS format.

isUnreadboolean

(optional) - Indicates whether to return only threads with unread messages. If not provided, it defaults to false.

Response

OK

IDinteger

ID of the thread

ParentType'RUReservation' | 'PMSReservation' | 'Contact'

Type of object the thread is attached to

ParentIDinteger

ID of the object the thread is attached to

LastMessageIDinteger

ID of the last message in the thread

LastMessageDatestring date-time

Date and time of the last message in the thread

Changes

No recorded changes to this operation across all 1 revision of this API.