Get messages

Get messages. GET /api/ext/v3/conversations/{target}/messages. The response includes the conversation's channel_id, which can be null if no channel ID was resolved.

Permissions

For API access tokens and OIDC tokens, satisfy at least one of: api, conversationsv3:read, wati_integration:read. API access tokens may satisfy a listed scope through the configured scope hierarchy; OIDC tokens are checked against their scope claims. Legacy JWT authentication does not use this scope check. Authentication, role, tenant, and applicable feature or plan checks still apply. For HTTP 403, check the credential type, applicable scopes, roles, and workspace access; 403 does not always mean a missing scope. Authentication/authorization failures do not guarantee a JSON response body.

For accepted identifier formats and 404 recovery, see BSUID and Target Format. Use the conversation id from a relevant conversation result, not its contact_id; preserve BSUID/channel case and encode target as a single path segment.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Supported target formats for this conversation resolver:

  • ConversationId: the conversation's id, not a contact id. An object-id-shaped value is looked up as a conversation id; it does not fall back to a contact lookup.
  • PhoneNumber: the recipient number on the default channel.
  • Channel:PhoneNumber: the supported channel name/number and recipient number.
  • BSUID: the exact WhatsApp business-scoped identifier, where available for the workspace.
  • Channel:BSUID: the supported channel name/number and exact BSUID.
    Preserve BSUID/channel case and use the client URL encoder for one target path segment. See BSUID and Target Format for endpoint-family differences and identifier provenance.
Query Params
int32
required

Page number (1-based).

int32
required

Number of items per page (max 100).

Responses

401

The request is unauthorized.

429

Too many requests. Either the rate limit has been exceeded or usage limits have been reached.

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