Chats

List unread messages

Returns the messages your company has not read yet, across every chat, with the chats they belong to.

GET

https://api.portal.magicdoor.com/company-app/chats/unread-messages

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Query parameters

pageinteger

Which page to return. The first page is 1.

default: 1example: 1

pageSizeinteger

How many items to return per page. Between 1 and 100.

default: 50example: 25

messageTypeenum<string>

Which kind of message to count as unread.

default: participantparticipantpropertyManagerbotannouncement

Response

200 · One page of unread messages.

itemsChatMessage[]

The unread messages, one page at a time.

currentPageinteger

The page number that was returned.

totalPagesinteger

How many pages exist at this page size.

pageSizeinteger

How many items a page holds.

totalCountinteger

How many items match in total, across every page.

chatsChat[]

The chats the messages in items belong to, so you can show each message in context without another call.

401 · The access token is missing, expired, or not valid.

By default only messages from the other side — the tenant, owner, or vendor — are returned. Set messageType to look at your team's own messages, the AI's, or announcements instead.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/chats/unread-messages?page=1&pageSize=25' \
  --header 'Authorization: Bearer <token>'

Response

{
  "items": [
    {
      "id": "1831055120837640192",
      "chatId": "1830472847398404096",
      "messageType": "participant",
      "source": "text",
      "participantId": "1830472847398404100",
      "message": "Is the water going to be off on Thursday?",
      "messageLanguage": "en",
      "translatedFailed": false,
      "aiEnhanced": false,
      "sentAt": "2026-08-17T14:32:10",
      "files": [],
      "read": false,
      "readAt": "2026-08-17T14:32:10",
      "sendText": false,
      "textStatus": "delivered",
      "textSentAt": "2026-08-17T14:32:11",
      "textDeliveredAt": "2026-08-17T14:32:16",
      "sendEmail": false,
      "aiProcessingStatus": "processed",
      "aiProcessedAt": "2026-08-17T14:32:12"
    }
  ],
  "currentPage": 1,
  "totalPages": 1,
  "pageSize": 25,
  "totalCount": 3,
  "chats": [
    {
      "id": "1830472847398404096",
      "type": "lease",
      "typeKey": "1829833104612495360",
      "subject": "4B - Willow Creek",
      "participants": [
        {
          "id": "1830472847398404100",
          "participantType": "tenant",
          "accountId": "1827991044238376960",
          "fullName": "Marcus Webb",
          "phoneNumber": "(208) 555-0117",
          "email": "marcus.webb@example.com",
          "active": true,
          "tenant": {
            "id": "1827991044238376960",
            "active": true,
            "firstName": "Marcus",
            "lastName": "Webb",
            "email": "marcus.webb@example.com",
            "phone": "(208) 555-0117",
            "language": "en",
            "chatId": "1830472847398404096",
            "portalStatus": "active",
            "lastSeen": "2026-08-16T19:41:07",
            "icons": [],
            "created": "2026-02-11T10:05:33",
            "updated": "2026-07-30T16:22:09"
          }
        }
      ],
      "participantLanguage": "en",
      "closed": false,
      "pinned": false,
      "groupNumber": "(208) 555-0100",
      "messageCount": 14,
      "unreadMessages": 0,
      "latestMessageId": "1831055120837640192",
      "lastMessageSentAt": "2026-08-17T14:32:10",
      "created": "2026-03-01T09:00:00",
      "assignedPropertyManager": {
        "id": "1820011923988709376",
        "companyId": "1810119284757463040",
        "email": "dana@brightsidepm.com",
        "phone": "(208) 555-0142",
        "firstName": "Dana",
        "lastName": "Ortiz",
        "name": "Dana Ortiz",
        "active": true,
        "created": "2025-11-03T08:20:15",
        "lastSeen": "2026-08-17T13:58:02"
      },
      "assignedAt": "2026-08-10T11:04:23",
      "lease": {
        "id": "1829833104612495360",
        "portfolioId": "1823772785993383936",
        "propertyId": "1824559920033832960",
        "unitId": "1828440183928913920",
        "start": "2026-03-01",
        "end": "2027-02-28",
        "ended": false,
        "monthToMonth": false,
        "eviction": false,
        "draft": false,
        "status": "lease",
        "expiringStatus": "none",
        "chatId": "1830472847398404096",
        "tenants": [
          {
            "tenantId": "1827991044238376960",
            "moveIn": "2026-03-01"
          }
        ],
        "balance": 0,
        "postedBalance": 0,
        "currentRent": 1850,
        "securityDepositRequested": 1850,
        "securityDepositPaid": 1850,
        "securityDepositDue": 0,
        "lastPaymentDate": "2026-08-01",
        "icons": []
      },
      "propertyType": "multiFamily",
      "propertyId": "1824559920033832960",
      "unitId": "1828440183928913920"
    }
  ]
}