{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Deliverability Error Codes","type":"basic","slug":"deliverability-error-codes","excerpt":"","body":"##Error Types##\n  1.  Provider Detected Client Errors\n  2.  Carrier Reported Client Errors\n  3.  Provider Service Failures\n  4.  Carrier Reported Service Failures\n  5.  Carrier Errors with Ambiguous Cause\n<br />\n\n**Provider Detected Client Errors**\nA 4xxx code indicates that provider or the downstream carrier has identified some element of the message request unacceptable. Repeating the request will produce the same result.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"4001, 30008\",\n    \"1-0\": \"4121, 4470, 30004\",\n    \"0-1\": \"Message was rejected for reasons other than those covered by other 4xxx codes\",\n    \"1-1\": \"Rejected as SPAM\",\n    \"2-1\": \"Could not download media\",\n    \"3-1\": \"Combined size of media too large\",\n    \"2-0\": \"4410\",\n    \"3-0\": \"4411\",\n    \"4-1\": \"No Route to Destination Carrier\",\n    \"4-0\": \"4420, 4421\",\n    \"5-0\": \"4431\",\n    \"5-1\": \"Messaging on shortcode forbidden\",\n    \"6-0\": \"4432, 30011\",\n    \"6-1\": \"Messaging to country forbidden\",\n    \"7-1\": \"Messaging on Toll Free Number Forbidden\",\n    \"7-0\": \"4433\",\n    \"8-1\": \"Messaging to Toll Free Number Forbidden\",\n    \"9-1\": \"Too Many Recipients\",\n    \"10-1\": \"From Number in black list\",\n    \"11-1\": \"To Number in black list\",\n    \"8-0\": \"4434\",\n    \"9-0\": \"4435\",\n    \"10-0\": \"4481\",\n    \"11-0\": \"4482\",\n    \"12-1\": \"Message to emergency number forbidden\",\n    \"12-0\": \"4492\",\n    \"13-1\": \"Unauthorized\",\n    \"13-0\": \"4493\"\n  },\n  \"cols\": 2,\n  \"rows\": 14\n}\n[/block]\n\n**Carrier Reported Client Errors**\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"4700, 30006\",\n    \"0-1\": \"Carrier Rejected as Invalid Service Type\",\n    \"1-1\": \"Carrier Rejected as Invalid Destination Address\",\n    \"2-1\": \"Carrier Rejected as Invalid Source Address\",\n    \"3-1\": \"Carrier Rejected Message\",\n    \"4-1\": \"Message too long for carrier\",\n    \"5-1\": \"Carrier Rejected as SPAM\",\n    \"1-0\": \"4720, 30005\",\n    \"2-0\": \"4740\",\n    \"3-0\": \"4750, 30007\",\n    \"4-0\": \"4751, 30019\",\n    \"5-0\": \"4770\",\n    \"6-1\": \"Carrier Rejected due to user opt out\",\n    \"7-1\": \"Carrier rejected due to P2P volumetric violation\",\n    \"6-0\": \"4775\",\n    \"7-0\": \"4780, 30001\",\n    \"8-1\": \"On deactivation list\",\n    \"8-0\": \"4721\",\n    \"9-0\": \"4790\",\n    \"9-1\": \"Carrier Rejected Due to Short Code Restriction\",\n    \"10-1\": \"Carrier Rejected Short Code Campaign Not Allowed\",\n    \"11-1\": \"Carrier Rejected Short Code Not Provisioned\",\n    \"12-1\": \"Carrier Rejected Short Code Expired\",\n    \"10-0\": \"4791\",\n    \"11-0\": \"4792\",\n    \"12-0\": \"4793\",\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 13\n}\n[/block]\n**Provider Service Failures**\nA 5xxx code indicates that either the provider or the downstream carrier has reported a service failure. For provider failures, the customer can retry the request and expect a different result. For carrier errors, a retry may also yield a different result, however the customer should limit to a single retry attempt.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"5100, 5101, 5111, 5112, 5143, 5144, 5146, 5201, 5211, 5220, 5231\",\n    \"0-1\": \"Application Error\",\n    \"1-0\": \"5106\",\n    \"1-1\": \"Impossible to route / Attempt to deliver through retries has failed.\",\n    \"2-0\": \"5500, 5501, 31000\",\n    \"2-1\": \"General Message Send Failure\",\n    \"3-0\": \"5503\",\n    \"3-1\": \"Service Unavailable\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n**Carrier Reported Service Failures**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"5600, 30017\",\n    \"0-1\": \"Carrier Service Unavailable\",\n    \"1-0\": \"5610, 5650\",\n    \"2-0\": \"5620, 5630\",\n    \"3-0\": \"5999\",\n    \"3-1\": \"Unknown error from downstream\",\n    \"1-1\": \"Carrier Service Failure\",\n    \"2-1\": \"Carrier Application Error\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n**Carrier Errors with Ambiguous Cause**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"9902\",\n    \"0-1\": \"Timed out waiting for delivery receipt. The reason a delivery receipt was not received is not known\",\n    \"1-0\": \"9999\",\n    \"1-1\": \"Unknown error from downstream. Carrier reported a failure code that is unknown to the provider\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]","updates":[],"order":7,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed5d9d5e0b04f002584367b","createdAt":"2020-06-02T04:47:17.938Z","user":"5db22ff7092919001287fb3a","category":{"sync":{"isSync":false,"url":""},"pages":["55494bb26a82a10d00817afc","5549658ecd09b317005f8f58","554965a8a5ecbc1900321685","55498e2dc634cf2d001250c7","554a87c36b448d0d00646bc9","554a87d838e3620d0082194b","554a87e4d665ae0d00383f8f","554a897b38e3620d00821956","554a92acb4322819002b69f7","554d0db6374fec0d007e648b","56ec765c3b656b0e00d86202"],"title":"How Sonar Works","slug":"how-sonar-works","order":1,"from_sync":false,"reference":false,"_id":"55494ba7ee219b0d001743c8","__v":11,"version":"55208137623ff50d009b2bef","createdAt":"2015-05-05T23:00:55.743Z","project":"55208137623ff50d009b2bec"},"version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["55208138623ff50d009b2bf0","55494a226a82a10d00817ae5","55494ba7ee219b0d001743c8","55494bc1ee219b0d001743cc","56ead8c1df765617008bccaf","573a2073dd007d1700cf288f","579695b1f64c9f0e007cd76c","57969e3dfa1ff60e006a1274","579a4592fd9f3c0e008e4f4a","57ab9afe54fa780e006c5430","57b784f5b7ebd60e009cb4a6","58f686818193090f008cec76","59e79fbd4cf31900341d50c6","5b2436973fd93f0003dcf99d","5d824fb2ce98a801366098a2"],"_id":"55208137623ff50d009b2bef","createdAt":"2015-04-05T00:26:31.564Z","releaseDate":"2015-04-05T00:26:31.563Z","__v":15,"project":"55208137623ff50d009b2bec"},"project":"55208137623ff50d009b2bec","__v":0,"parentDoc":null}

Getting Started Guide

How Sonar Works

Features

Public API

Integrations

Facebook Messenger

Product Updates

Salesforce Package Updates

Deliverability Error Codes

##Error Types## 1. Provider Detected Client Errors 2. Carrier Reported Client Errors 3. Provider Service Failures 4. Carrier Reported Service Failures 5. Carrier Errors with Ambiguous Cause <br /> **Provider Detected Client Errors** A 4xxx code indicates that provider or the downstream carrier has identified some element of the message request unacceptable. Repeating the request will produce the same result. [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "4001, 30008", "1-0": "4121, 4470, 30004", "0-1": "Message was rejected for reasons other than those covered by other 4xxx codes", "1-1": "Rejected as SPAM", "2-1": "Could not download media", "3-1": "Combined size of media too large", "2-0": "4410", "3-0": "4411", "4-1": "No Route to Destination Carrier", "4-0": "4420, 4421", "5-0": "4431", "5-1": "Messaging on shortcode forbidden", "6-0": "4432, 30011", "6-1": "Messaging to country forbidden", "7-1": "Messaging on Toll Free Number Forbidden", "7-0": "4433", "8-1": "Messaging to Toll Free Number Forbidden", "9-1": "Too Many Recipients", "10-1": "From Number in black list", "11-1": "To Number in black list", "8-0": "4434", "9-0": "4435", "10-0": "4481", "11-0": "4482", "12-1": "Message to emergency number forbidden", "12-0": "4492", "13-1": "Unauthorized", "13-0": "4493" }, "cols": 2, "rows": 14 } [/block] **Carrier Reported Client Errors** [block:parameters] { "data": { "0-0": "4700, 30006", "0-1": "Carrier Rejected as Invalid Service Type", "1-1": "Carrier Rejected as Invalid Destination Address", "2-1": "Carrier Rejected as Invalid Source Address", "3-1": "Carrier Rejected Message", "4-1": "Message too long for carrier", "5-1": "Carrier Rejected as SPAM", "1-0": "4720, 30005", "2-0": "4740", "3-0": "4750, 30007", "4-0": "4751, 30019", "5-0": "4770", "6-1": "Carrier Rejected due to user opt out", "7-1": "Carrier rejected due to P2P volumetric violation", "6-0": "4775", "7-0": "4780, 30001", "8-1": "On deactivation list", "8-0": "4721", "9-0": "4790", "9-1": "Carrier Rejected Due to Short Code Restriction", "10-1": "Carrier Rejected Short Code Campaign Not Allowed", "11-1": "Carrier Rejected Short Code Not Provisioned", "12-1": "Carrier Rejected Short Code Expired", "10-0": "4791", "11-0": "4792", "12-0": "4793", "h-0": "Code", "h-1": "Description" }, "cols": 2, "rows": 13 } [/block] **Provider Service Failures** A 5xxx code indicates that either the provider or the downstream carrier has reported a service failure. For provider failures, the customer can retry the request and expect a different result. For carrier errors, a retry may also yield a different result, however the customer should limit to a single retry attempt. [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "5100, 5101, 5111, 5112, 5143, 5144, 5146, 5201, 5211, 5220, 5231", "0-1": "Application Error", "1-0": "5106", "1-1": "Impossible to route / Attempt to deliver through retries has failed.", "2-0": "5500, 5501, 31000", "2-1": "General Message Send Failure", "3-0": "5503", "3-1": "Service Unavailable" }, "cols": 2, "rows": 4 } [/block] **Carrier Reported Service Failures** [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "5600, 30017", "0-1": "Carrier Service Unavailable", "1-0": "5610, 5650", "2-0": "5620, 5630", "3-0": "5999", "3-1": "Unknown error from downstream", "1-1": "Carrier Service Failure", "2-1": "Carrier Application Error" }, "cols": 2, "rows": 4 } [/block] **Carrier Errors with Ambiguous Cause** [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "9902", "0-1": "Timed out waiting for delivery receipt. The reason a delivery receipt was not received is not known", "1-0": "9999", "1-1": "Unknown error from downstream. Carrier reported a failure code that is unknown to the provider" }, "cols": 2, "rows": 2 } [/block]