Skip to main content
JSON
{
  "error": {
    "message": "Your request could not be completed.",
    "request_id": "9363e662-c1a5-4f16-a9cc-654b5ed574a9"
  }
}
Smile.io uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, while codes in the 4xx or 5xx range indicate a problem and will be accompanied by a JSON error object in the response body providing more information.

​
Error response codes

Status CodeDescription
400The request was not accepted by the server, often due to forgotten parameters, bad syntax, or a missing Content-Type header.
401The required authentication credentials are missing from the request or are incorrect.
403The server is refusing to respond to the request, usually because you are requesting a resource or querying an endpoint you do not have access or permission to see/use.
404The requested resource doesn’t exist.
422The request body was well-formed but contains logical or semantic errors (e.g. trying to redeem more points than the customer has). Refer to the response body for further information.
429The request was not accepted because your API consumer has exceeded it’s rate limit.
500An internal error occurred in Smile. Simplify or retry your request. If the issue persists, please record any error codes, request IDs, and timestamps, and contact Smile’s support.
503The server is currently unavailable. Check the Smile Status Page for any reported outages.