GET /obp/v7.0.0/signal-channels/CHANNEL_NAME/messages

Fetch messages from a signal channel with offset/limit pagination.

Signal channels provide short-lived, Redis-backed messaging designed for AI agent discovery and coordination, but usable by any authenticated OBP consumer.

Messages are returned oldest-first. Every message carries a per-channel monotonic sequence stamped when it was published.

Privacy filtering is applied server-side: you will only see broadcast messages (no to_user_id) and private messages addressed to you (to_user_id matches your user ID) or sent by you.

To poll, use after_sequence, not offset: ?after_sequence=<last sequence you saw>&limit=50 returns only newer messages. A channel keeps just its newest messages (default 1000) and trims the oldest, which moves list positions, so a poller that tracks an offset silently skips messages once the channel fills. The response's next_after_sequence is the value to send next; it advances even when every message in the window was private to someone else, and has_more says whether newer messages remain. latest_sequence is the newest message in the channel. Start with after_sequence=0 for everything the channel still holds.

Without after_sequence, offset and limit page over the channel's current contents.

total_count is the number of messages in the channel including private messages hidden from you, so it can be larger than the number of messages returned. visible_count is the number you may see, over the whole channel, and is the one to compare with what you have received. Neither is a way to detect missed messages; use after_sequence and next_after_sequence for that.

Authentication is Required.

User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

CHANNEL_NAME: CHANNEL_NAME

{ "channel_name": "discovery", "messages": [ { "message_id": "d8839721-2e41-4c60-9bba-42c5a7164027", "sequence": 1771583400123456, "channel_name": "discovery", "sender_consumer_id": "7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh", "sender_user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1", "timestamp": "2026-02-20T10:30:00Z", "message_type": "announce", "payload": { "agent_name": "my-agent", "capabilities": [ "summarize", "search" ] } } ], "total_count": 1, "has_more": false, "latest_sequence": 1771583400123456, "next_after_sequence": 1771583400123456, "visible_count": 1 }