Skip to main content
GET
/
{phone_number_id}
/
messages
/
{message_id}
Get message by ID
curl --request GET \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{phone_number_id}/messages/{message_id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "wamid.HBgNMTU1NTE0OTU5Nzg1FQIAERgSMDhGRjdBMDEyOTcxQzFFQkFBAA==",
  "timestamp": "1705328096",
  "type": "text",
  "from": "15551234567",
  "text": {
    "body": "Hello! I need help with my order"
  },
  "kapso": {
    "direction": "inbound",
    "status": "delivered",
    "processing_status": "completed",
    "phone_number": "+15551234567",
    "has_media": false,
    "whatsapp_conversation_id": "123e4567-e89b-12d3-a456-426614174000",
    "contact_name": "John Doe",
    "content": "Hello! I need help with my order"
  }
}

Authorizations

​
X-API-Key
string
header
required

Project API key for authentication. This is the recommended authentication method.

Get your API key from the Kapso dashboard under Integrations > API keys.

Path Parameters

​
phone_number_id
string
required

WhatsApp Business Phone Number ID

​
message_id
string
required

WhatsApp message ID

Query Parameters

​
fields
string

Filter response fields. Use kapso() to include Kapso-specific extensions.

Example: fields=kapso(direction,status,processing_status)

Response

Successfully retrieved message

​
id
string
required

Message ID

Example:

"wamid.HBgNMTU1NTE0OTU5Nzg1FQIAERgSMDhGRjdBMDEyOTcxQzFFQkFBAA=="

​
timestamp
string
required

Message timestamp (Unix timestamp as string)

Example:

"1705328096"

​
type
enum<string>
required

Type of WhatsApp message

Available options:
text,
image,
video,
audio,
document,
sticker,
location,
contacts,
interactive,
template,
reaction
​
from
string | null

Sender WhatsApp ID (phone-based identity when available)

Example:

"15551234567"

​
from_user_id
string | null

Sender business-scoped user ID when available

Example:

"US.13491208655302741918"

​
from_parent_user_id
string | null

Sender parent business-scoped user ID when available

Example:

"US.ENT.506847293015824"

​
to
string | null

Recipient WhatsApp ID (phone-based identity when available)

Example:

"110987654321"

​
to_user_id
string | null

Recipient business-scoped user ID when available

Example:

"US.13491208655302741918"

​
to_parent_user_id
string | null

Recipient parent business-scoped user ID when available

Example:

"US.ENT.506847293015824"

​
username
string | null

WhatsApp username when available

Example:

"@testusername"

​
context
object

Reply context

​
text
object
​
image
object
​
video
object
​
audio
object
​
document
object
​
sticker
object
​
location
object
​
contacts
object[]
​
order
object
​
interactive
object

Interactive message content (for inbound interactive responses).

​
template
object

Template message content

​
reaction
object
​
kapso
object

Kapso-specific message extensions