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 Code

Details

200 OK

The request was successfully processed by Shoplazza.

400 Bad Request

The 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 Unauthorized

The necessary authentication credentials are not present in the request or are incorrect.

403 Forbidden

The 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 Found

The requested resource was not found.

405 Method Not Allowed

The server recognizes the request but rejects the specific HTTP method.

406 Not Acceptable

the 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 Entity

The 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 Requests

The 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 Error

An 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.