Response status codes

Shoplazza API response status and error codes

The following table provides an overview of common HTTP status codes and their meanings when interacting with the Shoplazza API:

Status CodeDetails
200 OKThe request was successfully processed by Shoplazza.
400 Bad RequestThe request wasn't understood by the server, generally due to bad syntax or because the Content-Type header wasn't set to application/json.
- Returned when a request is missing valid authentication credentials or the credentials provided are invalid.
- Returned when the request includes invalid input format or request structure (e.g., missing required fields or incorrect data types).
401 UnauthorizedThe necessary authentication credentials are not present in the request or are incorrect.
403 ForbiddenThe server is refusing to respond to the request. This status is generally returned if the application hasn't requested the appropriate scope for the action.
404 Not FoundThe requested resource was not found.
405 Method Not AllowedThe server recognizes the request but rejects the specific HTTP method.
406 Not Acceptablethe server cannot produce a response that matches the client's request, e.g. refund an order which is not in after-sale status.
422 Unprocessable EntityThe request parameters are formatted incorrectly. Common causes for this error include:
Incorrect parameter types: For example, the published_status parameter has an invalid value.
Incorrect time format: The created_at_min, created_at_max, updated_at_min, updated_at_max, published_at_min, and published_at_max parameters do not follow the correct time format.
Invalid parameter values: For instance, the ids parameter is non-existent or has an incorrect format.
Internal server error: In rare cases, the server itself may encounter an issue and return a 422 error.
429 Too Many RequestsThe request was not accepted because the application has exceeded the API rate limit. Adjust request frequency. Learn more about Shoplazza's API rate limits.
500 Internal Server ErrorAn internal error occurred in Shoplazza. Simplify or retry your request. If the issue persists, record any error codes and timestamps and contact Partner Support for assistance.