How to Troubleshoot Error 30003 (Unreachable destination handset)

If a message that you sent is not delivered to the receiving device and returns a 30003 error code, this means that the delivery of your message failed as the destination handset you are trying to reach is switched off or not available.

There are a number of possible reasons for this error:

  • Destination handset intended to be reach isn't on or isn't available.
  • Device/destination handset's signal isn't sufficient enough
  • Destination handset/device isn't capable of receiving SMS, such as a landline number
  • Mobile carrier has an issue

Troubleshooting to consider:

  • Is the destination headset/device on?
  • Is there a sufficient signal on the destination headset/device? Try powering off. wait 30 seconds and then powering back on
  • Is the destination headset/device connected to the main carrier network? Message delivery cannot be guaranteed on headsets/devices that are roaming off-network.
  • Can non-SignalWire SMS be received on the handset/device?
  • Try sending a message from another SignalWire number or with a shorter one-segment body.
  • Can other headset/devices on the same mobile carrier receive messages?

📘

Messages sent from short or long code numbers

Repeated error 30003 on undelivered messages can occur on messages sent from both short or long code numbers.

On short code, this can happen if the recipient's wireless plan doesn't support short code (or 'Premium') messages.

For long code, this can be due to carrier filtering. Carrier filtering rules will vary throughout the industry, so it may be difficult to determine the exact reason.

SignalWire support can help investigate what went wrong with our carrier peers. Please open a support request and include a minimum of 3 or more message SIDs that were flagged with the 30003 error. Per our carrier peers' requirements, we request that these SIDs be from the last 24 hours and be no older than 48 hours at most.


Did this page help you?