# Unread and waiting totals

`GET /api/reporting/v1/conversations/unread-summary`  (operationId: `unreadSummary`, group: Reporting)

Workspace totals: how many chats have unread messages, how many customers are waiting for a reply, the longest wait, and the same split by assignee. Aggregates only; no phone numbers.

Part of the full API, which is included in the Scale plan. Any one of these scopes is enough: `inbox`, `team_management`, `analytics`, `inbox:read`, `team_management:read`, `analytics:read`. Team accountability data: who opened, who replied, how fast.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `since` | query | string (date-time) | no | Start of the window: an ISO 8601 timestamp or a date (YYYY-MM-DD, start of that UTC day). Default: 30 days ago. Alias: from. |
| `to` | query | string (date-time) | no | End of the window (ISO 8601 or date). Default: now. Alias: until. |

**Response 200**: OK (schema `UnreadSummary`)

| Field | Type | Description |
| --- | --- | --- |
| `window` | Window |  |
| `window.from` | string (date-time) | Start of the window. |
| `window.to` | string (date-time) | End of the window. |
| `unread_chats` | integer |  |
| `unread_messages` | integer |  |
| `oldest_unread_at` | string (date-time), nullable | Oldest unread customer message. |
| `waiting_chats` | integer | Chats where the customer is waiting for a reply. |
| `oldest_waiting_since` | string (date-time), nullable | When the longest-waiting customer began waiting. |
| `longest_wait_seconds` | integer, nullable |  |
| `by_assignee` | array of object |  |
| `by_assignee[][].assigned_to` | MemberRef |  |
| `by_assignee[][].assigned_to.user_id` | integer | Team member user id. |
| `by_assignee[][].assigned_to.name` | string, nullable | Display name. |
| `by_assignee[][].unread_chats` | integer |  |
| `by_assignee[][].unread_messages` | integer |  |
| `by_assignee[][].oldest_unread_at` | string (date-time), nullable |  |
| `by_assignee[][].waiting_chats` | integer |  |
| `by_assignee[][].oldest_waiting_since` | string (date-time), nullable |  |
| `unassigned` | object |  |
| `unassigned.assigned_to` | object, nullable |  |
| `unassigned.unread_chats` | integer |  |
| `unassigned.unread_messages` | integer |  |
| `unassigned.oldest_unread_at` | string (date-time), nullable |  |
| `unassigned.waiting_chats` | integer |  |
| `unassigned.oldest_waiting_since` | string (date-time), nullable |  |

Example:

```json
{
  "window": {
    "from": "2026-09-02T00:00:00.000Z",
    "to": "2026-10-02T09:30:00.000Z"
  },
  "unread_chats": 12,
  "unread_messages": 31,
  "oldest_unread_at": "2026-10-01T04:12:00.000Z",
  "waiting_chats": 9,
  "oldest_waiting_since": "2026-10-01T04:12:00.000Z",
  "longest_wait_seconds": 105480,
  "by_assignee": [
    {
      "assigned_to": {
        "user_id": 41,
        "name": "Anita"
      },
      "unread_chats": 5,
      "unread_messages": 14,
      "oldest_unread_at": "2026-10-02T06:30:00.000Z",
      "waiting_chats": 4,
      "oldest_waiting_since": "2026-10-02T06:30:00.000Z"
    }
  ],
  "unassigned": {
    "assigned_to": null,
    "unread_chats": 7,
    "unread_messages": 17,
    "oldest_unread_at": "2026-10-01T04:12:00.000Z",
    "waiting_chats": 5,
    "oldest_waiting_since": "2026-10-01T04:12:00.000Z"
  }
}
```

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json