Mon-Fri 10am - 6pm
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.