Skip to main content

Errors

Zoho Commerce uses HTTP status codes to indicate success or failure of an API call. In general, status codes in the 2xx range means success, 4xx range means there was an error in the provided information, and those in the 5xx range indicate server side errors. Commonly used HTTP status codes are listed below.

HTTP Status Codes

Status CodeDescription
200Success: The request was successfully completed.
201 Created: The request was a success and one or more resources have been created.
400Bad request: The request cannot be performed. Usually because of malformed parameter or missing parameter.
401Unauthorized (Invalid AuthToken): Request was rejected because of invalid AuthToken
404URL Not Found: The URL youʼve sent is wrong. Itʼs possible that the resource youʼve requested has been moved to another URL.
405URL Not Found: The URL youʼve sent is wrong. Itʼs possible that the resource youʼve requested has been moved to another URL.
429Too many requests: Too many requests within a certain time frame. To know more about api call limits, click here.
500Server error: Zoho Commerce server encountered an error which prevents it from fulfilling the request. Although this rarely happens, we recommend you to contact us at support@zohocommerce.com if you receive this error.

 

Request Example

Copiedcurl -i -L -X GET
-H "Authorization:Zoho-oauthtoken ***"
-H "X-com-zoho-store-organizationid:58927961"
'https://commerce.zoho.com/store/api/v1/salesorders/51128000000104005'

Response Example

CopiedHTTP/1.1 404 Not Found
Content-Type: application/json;charset=UTF-8
Copied{
"code": 1002,
"message": "Sales Order does not exist."
}