Skip to main content
GET

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string
required

ID of the object.

Example:

"627c8640675de8fc689ab9d9"

Response

Successfully retrieved the group message.

One outbound group message. Group-level status is separate from member delivery results.

id
string
required

YCloud group-message ID.

Example:

"wam_group_01"

from
string
required

Sender phone number in E.164 format.

Example:

"+16315551111"

groupId
string
required

WhatsApp group ID.

Example:

"120363345678901234@g.us"

type
enum<string>
required
Available options:
text,
image,
video,
audio,
document,
sticker,
template
status
enum<string>
required

Group-level send status. accepted means YCloud accepted the request; sent and failed come from the group-level Meta result. expired may be returned when Meta reports expiry, but Group Message Logs filters expose only sent and failed.

Available options:
accepted,
sent,
failed,
expired
createTime
string<date-time>
required
direction
enum<string>
required
Available options:
outbound
recipients
object[]
required

Complete fixed recipient snapshot. Empty when the message failed before a reliable snapshot was obtained.

wamid
string

WhatsApp group-level message ID when Meta accepted the request.

Example:

"wamid.HBg..."

groupName
string

Group name captured for the message log.

Example:

"New Purchase Inquiry"

externalId
string

Customer-defined identifier from the send request.

template
object

Use for sending a WhatsApp template message.

text
object

WhatsApp Message Text Object.

image
object

Use for image, gif, video, audio, document, or sticker messages. See also Supported Media Types.

Note: Either id or link must be provided, but not both. These parameters are mutually exclusive.

Reference: WhatsApp Cloud API Media Object

video
object

Use for image, gif, video, audio, document, or sticker messages. See also Supported Media Types.

Note: Either id or link must be provided, but not both. These parameters are mutually exclusive.

Reference: WhatsApp Cloud API Media Object

audio
object

Use for image, gif, video, audio, document, or sticker messages. See also Supported Media Types.

Note: Either id or link must be provided, but not both. These parameters are mutually exclusive.

Reference: WhatsApp Cloud API Media Object

document
object

Use for image, gif, video, audio, document, or sticker messages. See also Supported Media Types.

Note: Either id or link must be provided, but not both. These parameters are mutually exclusive.

Reference: WhatsApp Cloud API Media Object

sticker
object

Use for image, gif, video, audio, document, or sticker messages. See also Supported Media Types.

Note: Either id or link must be provided, but not both. These parameters are mutually exclusive.

Reference: WhatsApp Cloud API Media Object

updateTime
string<date-time>
sendTime
string<date-time>

Present after the group-level status reaches sent.

groupMessageType
enum<string>

Group-level business pricing category reported by Meta.

Available options:
group_marketing,
group_utility,
group_service
groupMemberCount
integer

Total group participant count at send time, including the business sender. Omitted when no reliable snapshot was obtained.

recipientCount
integer

Fixed count of recipient members at send time. Later membership changes do not alter it. Omitted when no reliable snapshot was obtained.

sent
integer

Members currently in sent status.

delivered
integer

Members currently in delivered or read status.

read
integer

Members currently in read status.

failed
integer

Members currently in failed or expired status.

errorCode
string

Group-level failure code.

errorMessage
string

Group-level failure message.

totalPrice
number<double>

Sum of final member charges when every member charge is known and uses the same currency. Zero is a valid final total.

currency
string

ISO 4217 currency for totalPrice.

Example:

"USD"