API Errors

Throttled - You have exceeded the submission capacity allowed on this account. Please wait and retry

Missing params - Your request is incomplete and missing some mandatory parameters.

Invalid params - The value of one or more parameters is invalid.

Invalid tag - The tag value is invalid.

Invalid template - Invalid template or template parameters

Internal error - There was an error processing your request in the Platform.

Invalid message - The Platform was unable to process your request. For example, due to an unrecognised prefix for the phone number.

Number barred - The number you are trying to submit to is blacklisted and may not receive messages.

Partner account barred - The api_key you supplied is for an account that has been barred from submitting messages.

Partner quota exceeded - Your pre-paid account does not have sufficient credit to process this message.

Account not enabled for REST - This account is not provisioned for REST submission, you should use SMPP on the SMS API.

Message too long - The length of udh and body was greater than 140 octets for a binary type SMS request.

Communication Failed - Message was not submitted because there was a communication failure.

Illegal Sender Address - rejected - Due to local regulations, the SenderID you set in from in the request was not accepted. Please check the Global messaging section.

Invalid TTL - The value of ttl in your request was invalid.

Facility not allowed - Your request makes use of a facility that is not enabled on your account.

Invalid Message class - The value of message-class in your request was out of range. See https://en.wikipedia.org/wiki/Data_Coding_Scheme.

Non White-listed Destination - The phone number you set in to is not in your pre-approved destination list. To send messages to this phone number, add it using Dashboard.

Invalid or Missing Msisdn Param - The phone number you supplied in the to parameter of your request was either missing or invalid.

Absent Subscriber Temporary - This message was not delivered because to was temporarily unavailable. For example, the handset used for to was out of coverage or switched off. This is a temporary failure, retry later for a positive result.

Absent Subscriber Permanent - to is no longer active, You should remove this phone number from your database.

Portability Error - There is an issue after the user has changed carrier for to. If the user wants to receive messages from you, they need to contact their carrier directly.

Anti-Spam Rejection - Carriers often apply restrictions that block messages following different criteria. For example on SenderID or message content.

Handset Busy - The handset associated with to was not available when this message was sent. If status is rejected, this is a temporary failure; retry later for a positive result. If status is submitted, this message has is in the retry scheme and will be resent until it expires in 24-48 hours.

Network Error - A network failure while sending your message. This is a temporary failure, retry later for a positive result.

Illegal Number - You tried to send a message to a blacklisted phone number. That is, the user has already sent a STOP opt-out message and no longer wishes to receive messages from you.

Too many send requests - Too many send requests to phone numbers.

Unroutable - The chosen route to send your message is not available. This is because the phone number is either currently on an unsupported network or on a pre-paid or reseller account that could not receive a message.

Destination unreachable - The message could not be delivered to the phone number. If using Viber Business Messages your account might not be enabled for this country.

Subscriber Age Restriction - The carrier blocked this message because the content is not suitable for to based on age restrictions.

Number Blocked by Carrier - The carrier blocked this message. This could be due to several reasons. For example, to's plan does not include SMS or the account is suspended.

Message blocked by provider - The messaging provider has chosen to block this message. This may be due to content or restrictions imposed by the provider.

Pre-Paid - Insufficient funds - to’s pre-paid account does not have enough credit to receive the message.

Not part of the provider network - The number or ID is not a user in the provider network.

Not suitable device - The user's device can't receive the message.

Message already sent - The message was already sent.

Unknown - An unknown error was received from the carrier who tried to send this this message. Depending on the carrier, that to is unknown. When you see this error, and status is rejected, always check if to in your request was valid.

Provider error - The provider is not responding or unable to process the request. Please try sending your message in a few minutes time.

Outside of the allowed window - This message is sent outside of allowed response window.

Phone matching fee not paid - Requires phone matching access fee to be paid by the Facebook Page.

TTL was activated.

Expired access Token - Please reauthenticate your Facebook Page with Vonage.

Invalid resource - Please check that the URL your provided to your resource is accessible and valid.

Resource size is too large - Please try sending a smaller media file.

Resource type is invalid - Please check that the file you are trying to send is valid.

Unsupported channel - The channel specified in the request is not supported.

Invalid channel parameters - The value of one or more parameters is invalid.

Invalid sender - The from parameter is invalid for the given channel.

Invalid recipient - The to parameter is invalid for the given channel.

Invalid message type - The message type specified in the request is not supported for the given channel.

Invalid client reference - The client reference can be a string of up to 100 characters.

Invalid context - the reference to the original message could not be found because it is invalid or no longer available.

Daily message limit exceeded - Check compliance with regulations such as 10DLC.

Fraud Defender Traffic Rule - Rejected due to prefix block list.

Abnormal Sequential Dialing Detected - The High Density Contact Number Range threshold has been exceeded.

Abnormal Traffic Burst Detected - The Relative Increase threshold has been exceeded.

AIT protection - Enforcer reject due to AIT intelligence DB.

Fraud Score Exceeded - Enforcer reject due to fraud score threshold breach.

Entity Filter - The message failed due to entity_id being incorrect or not provided. More information on country specific regulations.

Header Filter - The message failed because the header ID (from phone number) was incorrect or missing. More information on country specific regulations.

Content Filter - The message failed due to content_id being incorrect or not provided. More information on country specific regulations.

Consent Filter - The message failed due to consent not being authorized. More information on country specific regulations.

Regulation Error - Unexpected regulation error - contact support.