Get chat messages for a WhatsApp group

Returns the messages sent in a WhatsApp group over a date range, oldest first, 30 per page.

Before you call

  • Pass the group's groupId and the connected wabaNumber the group belongs to.
  • The API key's user needs permission to view WhatsApp group info on the group's number.
  • startDate is required and endDate optional, both YYYY-MM-DD in UTC; the inclusive range may span at most 30 days.
  • endDate defaults to the end of today.

How it works

  • Returns groupId, groupName, messages and nextCursor.
  • Pass nextCursor back as the nextCursor query parameter for the next page; it is null when there are no more messages.
  • Only customer and agent messages are returned: text, template, image, video, audio, document, product and catalogue. System notices are skipped.
  • Returns 404 if the group is not found on that number or the number is not connected.

Rate limit

  • 60 requests per minute.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Unique identifier for the group

string
required

The WhatsApp Business Account (WABA) number

date
required

Inclusive start of the range (UTC). Example: 2026-04-15

date

Inclusive end of the range (UTC), at most 30 days from startDate. Defaults to the end of today if omitted. Example: 2026-05-14

string

Opaque pagination cursor returned by the previous page's response. Omit for the first page.

Responses

400

Invalid parameters, or the date range is inverted or longer than 30 days

401

Missing or invalid API key, or insufficient permissions for this group

404

No connected integration found for the given wabaNumber, or group not found for the given groupId

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json