Message logs

List message delivery logs

Changed on

List the messages your organization sent or received and what happened to each one — delivered, failed, or blocked — with the recipient and the failure reason. The same rows as Settings → Logs, so you can review delivery in bulk instead of opening conversations one at a time.

Statuses are a lifecycle, not a set of outcomes. SENT, DELIVERED and READ all mean the message went out; they differ only in how far it got. SENT means it left Boom and no receipt has come back yet. To count what you sent, ask for all three — asking for SENT alone returns only the ones still unconfirmed.

How far a message can get depends on the channel. WhatsApp reaches READ. Email never does: there is no read receipt, so an email resting at DELIVERED is fully settled. PENDING on an inbound message is normal and permanent — nobody sends a receipt for a message a customer wrote to you.

This is a log of messages, not a delivery-rate report. A few send failures never create a row at all, so an absent message is not proof that nothing was attempted.

get/api/v1/message-logs

Request

  • Base URL
    https://www.useboom.ai
  • Auth
    HTTP bearer

Query parameters

'PENDING' | 'SENT' | 'DELIVERED' | 'READ' | 'FAILED'
OR
string[]
OR
string
'WHATSAPP' | 'EMAIL' | 'SMS' | 'VOICE' | 'WEB_CHAT' | 'WEB_WIDGET' | 'FACEBOOK_MESSENGER' | 'INSTAGRAM'
OR
string[]
OR
string
direction'INBOUND' | 'OUTBOUND'

Defaults to OUTBOUND — a delivery status only means something for a message you sent. Pass INBOUND for what customers sent you.

createdAfterstring

Only messages created at or after this moment. A date (2026-08-01) or a full ISO 8601 timestamp.

createdBeforestring

Only messages created at or before this moment. A date (2026-08-01) or a full ISO 8601 timestamp.

searchstring

Match the recipient's name, phone or email address. A phone matches in any format. Over MCP, refused with sensitive_field when the organization hid any of those fields.

limitinteger

Page size, up to 1000.

cursorstring

Opaque cursor from a previous page.

Response

Success

next_cursorstring nullable required

Changes