---
title: REST API Error Codes 
description: SMS Global Knowledgebase
---

[![](https://cdn.craft.cloud/ff00d28e-6061-427e-b58d-8267ebeaad6b/builds/a173c27c-7ed2-40a3-b553-3262aea64d9e/artifacts/dist/img/logo/sms-global-logo.svg)](https://smsglobal.com?hsLang=en-au)

 smsglobal.com [Talk to an expert](https://www.smsglobal.com/contact?hsLang=en-au)  Talk to an expert

[Skip to content](https://knowledgebase.smsglobal.com/rest-api-error-codes-smsglobal-help-center#main-content)

[![SMSGLOBAL LOGO WHITE-2](https://knowledgebase.smsglobal.com/hs-fs/hubfs/SMSGLOBAL%20LOGO%20WHITE-2.png?width=500&height=100&name=SMSGLOBAL%20LOGO%20WHITE-2.png)](https://www.smsglobal.com/?hsLang=en-au)

Open main navigation

Close main navigation

- [Contact us](https://www.smsglobal.com/contact/)

[Contact us](https://www.smsglobal.com/contact/?hsLang=en-au)

 Advice and answers from the SMSGlobal Team

- There are no suggestions because the search field is empty.

1. [SMS Global Knowledgebase](https://knowledgebase.smsglobal.com/?hsLang=en-au)
2. [API and Integration](https://knowledgebase.smsglobal.com/api-and-integration?hsLang=en-au)

# REST API Error Codes 

## Common REST API error codes and troubleshooting steps to resolve them

The following response codes apply to all requests. Check each request type in the list below for more response codes specific to that request. For more information, please see our [REST API Documentation.](http://smsglobal.com/rest-api/?_ga=1.75715861.1477567143.1488234285&hsLang=en-au)

See below for details of error status codes, as well as the error meaning and description.

---

**200**

**OK**

The request was processed successfully.

**400**

**Bad Request**

Your request contained invalid or missing data.

**401**

**Unauthorized**

Authentication failed, or the Authenticate header was not provided.

**403**

**HMAC-SHA Authentication Failed**  
Things to check for:

- Ensure the REST API keys are correct, as well as the time they are authenticating with.
- The URI is correct.
- The computer/server must have accurate time as the authentication MAC is build using the time. Authentication will fail if the client computer time is different to our server time (not time-zone specific).
- The time gap for successful authentication is within 30 seconds.
- Also, check if the same nonce is in use for multiple requests. If the same nonce is used again, the request will return error 403.
- To prevent replay attacks, a single nonce can only be used once.

**404**

**Not Found**

The URI does not match any of the recognised resources, or if you are asking for a specific resource with an ID, that resource does not exist.

**405**

**Method Not Allowed**

The HTTP request method you are trying to use is not allowed. Make an OPTIONS request to see the allowed methods.

**406**

**Not Acceptable**

The Accept content type you are asking for is not supported by the REST API.

**415**

**Unsupported Media Type**

The Content-Type header is not supported by the REST API.

 Did this answer your question?😞😐😃

- [Sending a SMS](https://knowledgebase.smsglobal.com/sending-a-sms?hsLang=en-au)
- [Sender ID](https://knowledgebase.smsglobal.com/sender-id?hsLang=en-au)
- [API and Integration](https://knowledgebase.smsglobal.com/api-and-integration?hsLang=en-au)
- [Email to SMS](https://knowledgebase.smsglobal.com/email-to-sms?hsLang=en-au)
- [Reporting](https://knowledgebase.smsglobal.com/reporting?hsLang=en-au)
- [Sub-Accounts](https://knowledgebase.smsglobal.com/sub-accounts?hsLang=en-au)
- [Delivery Receipts](https://knowledgebase.smsglobal.com/delivery-receipts?hsLang=en-au)
- [Billing and Payments](https://knowledgebase.smsglobal.com/billing-and-payments?hsLang=en-au)
- [Contact Lists](https://knowledgebase.smsglobal.com/contact-lists?hsLang=en-au)
- [Managing Opt-Outs](https://knowledgebase.smsglobal.com/managing-opt-outs?hsLang=en-au)
- [Campaigns](https://knowledgebase.smsglobal.com/campaigns?hsLang=en-au)
- [Templates](https://knowledgebase.smsglobal.com/templates?hsLang=en-au)
- [MMS](https://knowledgebase.smsglobal.com/mms?hsLang=en-au)
- [Voice](https://knowledgebase.smsglobal.com/voice?hsLang=en-au)
- [Laws and Regulations](https://knowledgebase.smsglobal.com/laws-and-regulations?hsLang=en-au)
- [Video Tutorials](https://knowledgebase.smsglobal.com/video-tutorials?hsLang=en-au)
- [Account Settings](https://knowledgebase.smsglobal.com/account-settings?hsLang=en-au)
- [Understanding Unicode Messages](https://knowledgebase.smsglobal.com/understanding-unicode-messages?hsLang=en-au)

[![SMSGlobal](https://knowledgebase.smsglobal.com/hs-fs/hubfs/SMSGlobal-logo-black-transp.png?width=200&height=56&name=SMSGlobal-logo-black-transp.png "SMSGlobal")](http://smsglobal.com?hsLang=en-au)

[mailto:support@email.com](mailto:support@email.com)

Copyright © 2026, SMSGlobal

![](https://analytics.twitter.com/i/adsct?txn_id=nxnc4&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0) ![](https://t.co/i/adsct?txn_id=nxnc4&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0)

[![SMSGlobal](https://cdn.craft.cloud/ff00d28e-6061-427e-b58d-8267ebeaad6b/builds/a173c27c-7ed2-40a3-b553-3262aea64d9e/artifacts/dist/img/logo/sms-global-logo-light.svg)](https://smsglobal.com/?hsLang=en-au)

 © Copyright . SMSGlobal. All rights reserved.

[smsglobal.com](https://smsglobal.com/?hsLang=en-au) [Talk to an expert](https://smsglobal.com/contact/?hsLang=en-au)