Use the HTTP status and response message to identify and resolve errors returned by the Unifonic WhatsApp API.
| API error code | Response | Resolution |
|---|---|---|
| 400 Bad Request | {"message": "Invalid request sent.", "errors": errors} | The request failed payload validation. Correct the request body and try again. |
| 400 Bad Request | {"message": "Phone number {phone_number} does not exists in the list of testing phone numbers"} | The sandbox recipient is not one of the 10 configured test numbers. Add the number or use a configured recipient. |
| 401 Unauthorized | {"message": "Unauthorized"} | One or more authorization headers are missing. Add the required headers. |
| 402 Payment Required | {"message": "Application with ID: {application_id} belongs to an account which has no balance available."} | The account has insufficient balance. Add balance before retrying. |
| 402 Payment Required | {"message": "You have consumed the allocated Sandbox usage , Please contact Unifonic team"} | The account reached its sandbox usage limit. Contact Unifonic. |
| 403 Forbidden | {"message": "User is not authorized to access this resource with an explicit deny"} | One or more authorization headers are incorrect. Verify the credentials and permissions. |
| 500 Internal Server Error | {"message": "Sending messages is temporarily unavailable."} | The API service is temporarily unavailable. Retry according to your application's retry policy. |