This is a summary of what each status code group means. The way our status blocks works is that, for example, if the code starts with 1 then the status belongs to the status group Info. This allows us to add new status codes while still allowing your software to handle these new status codes without being explicitly developed for them.
Group
Code block
Comment
Info
1
Informative status codes that inform where the message is in the pipeline.
Success
2
If the message ended in a user-defined manner such as Expired or DeliveredToClient.
Rejection
4
If there is something wrong with the message it self such as length, banned keywords, etc.
Error
5
If the message was undeliverable or other errors which is out of the control for the delivery service.
Info
Name
Code
Treated as
Comment
Accepted
101
Info
The message(s) has been accepted for processing
Queued
102
Info
The message has been put a queue for sending
Funded
103
Info
The message has been paid for and can be sent
Refunded
104
Info
The message has been refunded i.e. its price has been returned to the account balance
DeliveredToGateway
111
Info
The message has been delivered to the next upstream gateway
QueuedAtGateway
114
Info
The message has been queued at the upstream gateway
Success
Name
Code
Treated as
Comment
DeliveredToClient
201
Success
The message has been delivered to the recipient in question
Expired
202
Success
The expiry date has been exceeded before the message could be delivered
Canceled
203
Success
Message was canceled by user
Rejection
Name
Code
Treated as
Comment
InsufficientFunds
402
Rejection
The account trying to send does not have enough balance to send the message
SenderRejected
403
Rejection
The sender was rejected, given when the sender is considered fraudulent or sender ownership hasn't been verified
RecipientRejected
405
Rejection
The recipient is illegal
GenericRejected
406
Rejection
The message was rejected for a reason other than the options above
InvalidSender
407
Rejection
The message sender is invalid. Eg. Sender is too long, contains illegal characters etc
InvalidContent
408
Rejection
Message content is invalid. Eg. illegal characters, is to long etc.
InvalidRecipient
409
Rejection
The recipient of the message is invalid, for example the recipient is not a valid email address
Spam
411
Rejection
The message was rejected due to a spam filter
HardBounce
412
Rejection
The message received a hard bounce, which means the recipient is invalid or no longer in use
SoftBounce
413
Rejection
The message received a soft bounce, meaning the recipient was unable to receive it
Error
Name
Code
Treated as
Comment
InternalError
500
Error
An unrecognized error occurred
Unknown
599
Error
Message was delivered upstream but no Delivery Receipt has been received or a Delivery Receipt that could not be interpreted was received