Skip to main content
flag
Mon - Fri   10:00 – 18:00

Message statuses and errors

API Documentation / WhatsApp / Message statuses and errors

Base URL for your account: https://cpaas.studio

GET /api/whatsapp/v1/messages/{ref} → error.code

The error codes a failed message carries (Message Status, the status webhook). Column 3 says whether the allowance is returned when a message fails with that code. provider_code (Meta's raw code) is returned alongside for your logs.

Parameters

Param Type Required Notes
blocked Blocked charged The recipient has blocked or restricted messages from this number.
capped Capped (frequency limit) charged WhatsApp limited marketing messages to this recipient.
delivered Delivered charged Delivered to the recipient. (not final)
failed_permanent Failed (permanent) charged The message could not be delivered.
failed_temporary Failed (temporary) charged The message could not be delivered right now. Please try again later.
invalid_number Invalid / not on WhatsApp charged This number is not a valid WhatsApp number.
read Read charged Read by the recipient.
rejected Rejected charged The message was rejected by WhatsApp.
unknown Unknown charged Delivery failed for an unclassified reason.

Request example

curl -X GET "https://cpaas.studio/api/whatsapp/v1/messages/{ref} → error.code" \
  -H "X-API-KEY: cpk_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Success response (data)

[]

Need more context? See Getting started for authentication, the response envelope, and the full error-code reference.