SMS error codes - delivery report

Giuseppe Cilona 0 Reputation points
2025-01-06T22:32:56.26+00:00

need some help with Billing.

What statuses do we get billed for ? Could you please Highlight the ones we are charged for?

2000 Message Delivered Successfully

4000 Message is rejected due to fraud detection Ensure you aren't exceeding the maximum number of messages allowed for your number

4001 Message is rejected due to invalid Source/From number format Ensure the To number is in E.164 format and From number format is in E.164 or Short code format

4002 Message is rejected due to invalid Destination/To number format Ensure the To number is in E.164 format

4003 Message failed to deliver due to unsupported destination Check if the destination you're trying to send to is supported

4004 Message failed to deliver since Destination/To number doesn't exist Ensure the To number you're sending to is valid

4005 Message is blocked by Destination carrier

4006 The Destination/To number isn't reachable Try resending the message at a later time

4007 The Destination/To number has opted out of receiving messages from you Mark the Destination/To number as opted out so that no further message attempts are made to the number

4008 You've exceeded the maximum number of messages allowed for your profile Ensure you aren't exceeding the maximum number of messages allowed for your number or use queues to batch the messages

4009 Message is rejected by Microsoft Entitlement System Most often this happens if fraudulent activity is detected. Please contact support for more details

4010 Message was blocked due to the toll-free number not being verified Review unverified sending limits and submit toll-free verification as soon as possible

5000 Message failed to deliver. Please reach out Microsoft support team for more details File a support request through the Azure portal

5001 Message failed to deliver due to temporary unavailability of application/system

5002 Carrier does not support delivery report Most often this happens if a carrier does not support delivery reports. No action required as message may have been delivered already.

9999 Message failed to deliver due to unknown error/failure Try resending the message

Azure Communication Services
Azure Communication Services
An Azure communication platform for deploying applications across devices and platforms.
959 questions
0 comments No comments
{count} votes

1 answer

Sort by: Most helpful
  1. Laxman Reddy Revuri 1,525 Reputation points Microsoft Vendor
    2025-01-07T04:12:35.42+00:00

    Hi @Giuseppe Cilona
    Thanks for the question and using MS Q&A platform.
    You are required to pay for only a single status code:

    2000 - Message has been delivered with success

    All the other status codes (4000-4010, 5000-5002, 9999) are free of charge. This includes all error messages, rejections and any message that was not or could not be delivered.

    In easier terms:

    If the message has been delivered (status 2000) = You are charged If the message could not be sent due to any reason (all other status codes) = You are not charged.
    references:
    https://zcusa.951200.xyz/en-us/azure/communication-services/resources/troubleshooting/voice-video-calling/troubleshooting-codes?pivots=sms#sms-error-codes
    https://zcusa.951200.xyz/en-us/azure/communication-services/overview
    Please accept as "Yes" if the answer provided is useful, so that you can help others in the community looking for remediation for similar issues.

     


Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.