Groupsv2

List groups

GET/groups

List all groups for the organization with optional search and pagination.

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

limitoptionalinteger

Maximum number of items to return in a single response. Must be between 1 and 200; defaults to 50. Use together with offset to page through large result sets.

offsetoptionalinteger

Number of items to skip before returning results. Combine with limit for page-based pagination (e.g. offset=50&limit=50 returns the second page). Defaults to 0.

qoptionalstring

Search query (matches group name)

sortoptionalstring

Sort order

"recent""oldest""name_asc""name_desc"

Returns

groupsoptionalGroup[]

Array of Group

group_idoptionalstring

nameoptionalstring | null

Group name. Null for unnamed groups.

chat_guidoptionalstring | null

BlueBubbles chat GUID if linked to a device group chat

icon_urloptionalstring | null

URL of the group icon/photo

member_countoptionalinteger

message_countoptionalinteger

Total number of messages in this group

last_message_textoptionalstring | null

Text of the most recent message in the group

last_message_timeoptionalinteger | null

Timestamp of the most recent message

last_message_directionoptionalstring

Direction of the most recent message

"inbound""outbound"

created_atoptionalinteger

paginationoptionalPagination

limitoptionalinteger

offsetoptionalinteger

totaloptionalinteger

Response codes

200List of groups

401Authentication required or invalid

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/v2/api/groups?limit=50&offset=0&q=string&sort=recent \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "groups": [    {      "group_id": "grp_a1b2c3d4",      "name": "Jane Doe",      "chat_guid": "grp_a1b2c3d4",      "icon_url": "https://example.com",      "member_count": 3,      "message_count": 3,      "last_message_text": "string",      "last_message_time": 0,      "last_message_direction": "inbound",      "created_at": 0    }  ],  "pagination": {    "limit": 50,    "offset": 1,    "total": 3  }}