BlueBubbles API Reference

Server Info

GET /api/v1/server/info?password={pass}

Returns: server_version, private_api status, proxy_service, detected_imessage account, OS version

Chat Listing

POST /api/v1/chat/query?password={pass}
Body: {"with": ["lastMessage", "participants"], "limit": 50, "offset": 0}

Returns: array of chat objects with guid, displayName, chatIdentifier, participants, lastMessageText

Chat Count

GET /api/v1/chat/count?password={pass}

Returns: { total, breakdown: { iMessage, SMS } }