{"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    \"6-0\": \"4775\",\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 7\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]\n**10DLC Specific Errors**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"30022\",\n    \"1-0\": \"30023\",\n    \"0-1\": \"US A2P 10DLC - Rate Limits Exceeded\\n\\nYour messages to this particular carrier has exceeded the maximum allowable limits for your phone number and/or campaign. * Your message was rejected by the downstream carriers for exceeding the rate limits.\",\n    \"1-1\": \"US A2P 10DLC - Daily Message Cap Reached\\n\\nYour messages to this particular carrier has exceeded the maximum allowable messages for the day. You have sent the maximum allowable daily messages for your Brand to the carrier.\"\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","61096ffb8de715001695ae54"],"_id":"55208137623ff50d009b2bef","createdAt":"2015-04-05T00:26:31.564Z","releaseDate":"2015-04-05T00:26:31.563Z","__v":16,"project":"55208137623ff50d009b2bec"},"project":"55208137623ff50d009b2bec","__v":0,"parentDoc":null}

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", "6-0": "4775", "h-0": "Code", "h-1": "Description" }, "cols": 2, "rows": 7 } [/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] **10DLC Specific Errors** [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "30022", "1-0": "30023", "0-1": "US A2P 10DLC - Rate Limits Exceeded\n\nYour messages to this particular carrier has exceeded the maximum allowable limits for your phone number and/or campaign. * Your message was rejected by the downstream carriers for exceeding the rate limits.", "1-1": "US A2P 10DLC - Daily Message Cap Reached\n\nYour messages to this particular carrier has exceeded the maximum allowable messages for the day. You have sent the maximum allowable daily messages for your Brand to the carrier." }, "cols": 2, "rows": 2 } [/block]