Eventsv4

List events

GET/events

Unified activity feed (message lifecycle, polls, groups, reactions, typing). Filter by type, chat, or message.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Query parameters

typeoptionalstring

Event type or wildcard, e.g. message.received or message.*.

chat_idoptionalstring

message_idoptionalstring

limitoptionalinteger

Maximum number of items to return per page. Must be between 1 and 200; defaults to 50. Combine with cursor to paginate.

cursoroptionalstring

Opaque pagination cursor. Pass the next_cursor value from a previous response to fetch the next page; omit it on the first request.

Returns

dataoptionalEvent[]

Array of Event

idoptionalstring

Event id (evt_...).

typeoptionalstring

e.g. message.delivered, poll.voted.

message_idoptionalstring | null

chat_idoptionalstring | null

channel_typeoptionalstring | null

occurred_atoptionalinteger

dataoptionalobject

has_moreoptionalboolean

next_cursoroptionalstring | null

Response codes

200A page of events

400The request was malformed — check the path, query parameters, and body.

401Your API key is missing or invalid. Pass it as a bearer token.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X GET https://api.blooio.com/v4/events?type=string&chat_id=chat_a1b2c3d4&message_id=msg_a1b2c3d4&limit=50&cursor=string \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "data": [    {      "id": "evt_a1b2c3d4",      "type": "string",      "message_id": "msg_a1b2c3d4",      "chat_id": "chat_a1b2c3d4",      "channel_type": "string",      "occurred_at": 0,      "data": {}    }  ],  "has_more": true,  "next_cursor": "string"}