Message Status Codes

Where ever supported we request that carriers return delivery receipts so that these can be passed to you and processed. While every attempt is made to ensure that a valid statusCode is passed, it can not be guaranteed as some devices/carriers or connections are not able to provide a true delivery receipt.

Possible values of statusCode are:

Code Basic Description What this means to your Application Final Status?

NUR

Number Unreachable

Check the number is correct and in International Format and then resend. The error string will also provide some more useful information such as whether the recipient is blocked. Be careful about infinite loops, only retry a couple of times.

Yes

SNT

Message Passed to Network

Wait. Give it a few minutes and then poll for more Status Messages.

No

ERR

Internal Error

An error occurred. It may be recoverable so try sending the message again in a few minutes. Be careful about infinite loops in your code.

Yes

NRCV or NRC

Not Received

Check the number is correct and in International Format and then resend. Be careful about infinite loops though.

Yes

RCV

Message Received

Excellent. This is a final status for this message and the handset has received it.

Yes

EXP

Message was not delivered within allowed time

This is a final status for this message and the handset has not received it. Retry if you want but for a lot of carriers this status may take days to return so the message may no longer be relevant.

Yes

INF

Insufficient funds

A billing error has occurred. If you get this error then your account has reached its credit limit. This is very rare and you need to contact Spark immediately. No more messages can be sent until this is rectified.

Yes