Error Responses

Shop Boss utilizes conventional HTTP status codes to signify the outcome of an API request. Our system is designed to return a variety of responses — 200, 4xx, and 5xx status codes — to communicate the status of each request clearly.

HTTP Status CodesCopied!

  • 200 OK: The request was successful, and the response returned as expected.

  • 400 Bad Request**: The request could not be processed due to incorrect syntax, invalid parameters, or issues with the request format.

  • 401 Unauthorized: Authentication failed due to invalid API key or access credentials.

  • 403 Forbidden: The API key provided does not have the necessary permissions for the requested resource.

  • 404 Not Found: The requested resource could not be found but may be available again in the future.

  • 422 Unprocessable Content: Request contains validation errors.

  • 429 Too Many Requests: Request was not accepted because the application has exceeded the rate limit.

  • 5xx Server Errors: These indicate problems on Shop Boss's end. Please report these errors to our support team.