Get message groups

GET {{baseUrl}}/v3/message_groups

Lists the v3 chat groups (channels) this user belongs to — their active territory, plus their current shift’s retreat point if checked into one. Source: group_messages/endpoints/getMessageGroupsController.ts → ChatWithContext type.

Response fields (array under data):

• group — the ChatGroup: id (use as groupId), name, entity_name (territories|retreat_points), entity_id.
• unread — unread message count for this user in this group.
• latest — the most recent ChatMessage in the group, or null if empty.

Examples

cURL

curl --request GET 'https://api.firstdelivery.com/api/v3/message_groups'

Node.js

const response = await fetch("https://api.firstdelivery.com/api/v3/message_groups", {
  "method": "GET",
  "headers": {}
})
const data = await response.json()

Python

import requests

response = requests.request(
    "GET",
    "https://api.firstdelivery.com/api/v3/message_groups",
    headers={},
)
response.raise_for_status()

Saved responses

200 200 OK

{
  "data": [
    {
      "group": {
        "id": 7,
        "name": "Downtown Territory",
        "entity_name": "territories",
        "entity_id": "b2b1c1a0-1111-4a2b-9c3d-4e5f6a7b8c9d"
      },
      "unread": 2,
      "latest": {
        "id": 1023,
        "group_id": 7,
        "from_user_id": "1f2e3d4c-dispatch-uid",
        "message_text": "Heads up, customer called",
        "media_urls": [],
        "user_name": "Dispatch",
        "user_role": "admin",
        "created_at": "2026-06-22T13:58:00.000Z"
      }
    }
  ]
}