VertexSMS LLM-readable site index
We use cookies to improve your experience on this site and serve more relevant content to you. By continuing to browse our site you agree to our use of cookies, revised Privacy Policy and Terms of Service.  More information about cookies
api documentation

Build it your way.
We'll wire it up.

Clean documentation, simple authentication, real-time callbacks.

Error codes in VertexSMS API are global for all callbacks (requests we make to you) like sms delivery reports, home routing lookup reports. API calls (requests you make to us) errors are based on http headers, more info here

CodeDescription
0No error occurred.
1Error from MSC, illegal subscriber.
2Message not delivered - validity period expired.
20Country or operator you trying send to, has not been configured for your account.
21SMS is blocked by filter ex.: number blacklisted. If you get this error and would like to get more details, please contact us support@vertexsms.com
22Dublicate SMS
23Limit of max SMS to one number reached
24Account balance limit reached
40The HLR responded with an error indicating the subscriber is unknown, probably don't exists in operator database, it's normal to repeat check for this subscriber after some time, and if you get this error again, MSISDN probably is not in use anymore.
41The HLR responded with an error indicating the SMS service is barred for the subscriber. You can get this error if operator blocking P2P SMS traffic to MSISDN.
43The HLR responded with an error indicating the subscriber is absent. Subscriber probably is out of the network range or the phone is turned off.
51Other/unknown HLR error, please contact VERTEXSMS support for more information.
53Invalid MSISDN.
999Unknown error from VERTEXSMS API