list_inbox_notifications
Retrieve inbox notifications with total unread count. Filter by category, such as mentions, to see what you missed or where you were mentioned.
Instructions
List your inbox notifications, with a total unread count.
USE WHEN: Answering "what did I miss" or "where was I mentioned" — pass category: "mentions" for mentions. The response includes total_unread, so you can report a count without paging.
USE INSTEAD: search_message_ids with notified_status if you want the messages themselves rather than notification records. search_messages_by_heard_status for unlistened messages.
EXAMPLE: {"category":"mentions","limit":25}
RETURNS: {results: [...], total_results, total_unread, filters}. Pages with skip/limit, not cursors.
NARROW: pass response_fields ["results","total_unread","total_results"] unless you need more — the full payload is much larger.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Anchor as a UNIX timestamp in MILLISECONDS (e.g. 1694313500106) — not an ISO string. | |
| skip | No | Offset for paging. This endpoint uses skip/limit, not cursors. | |
| type | No | Narrow to a single notification type (e.g. `channel.users.added`). Prefer `category` unless you know the exact type string. | |
| limit | No | Number of notifications to return (max 100). | |
| category | No | Notification category. `mentions` is the one to use for "where was I mentioned". | |
| direction | No | Direction to walk from the anchor. | newer |
| response_fields | No | Dot-path allowlist to shrink the response, e.g. ["results.id","total"]. Omit for the full payload. |