Errors
Zoho Billing 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 Code |
Description |
| 2xx |
Success |
| 4xx |
Bad request sent to server |
| 5xx |
Server side error |
| Status Code |
Description |
| 200 |
SuccessThe request was successfully completed. |
| 201 |
CreatedThe request was a success and one or more resources have been created. |
| 400 |
Bad requestThe request cannot be performed. Usually because of malformed parameter or missing parameter. |
| 401 |
Unauthorized (Invalid OAuthToken)Request was rejected because of invalid OAuthToken. |
403 |
ForbiddenThe user does not have enough permission or possibly not an user of the respective organization to access the resource. |
| 404 |
URL Not Found The URL you’ve sent is wrong. It’s possible that the resource you’ve requested has been moved to another URL. |
| 405 |
Method Not AllowedThe requested resource does not support the HTTP method used. For example, requesting List of all customers API with PUT as the HTTP method. |
| 406 |
Not AcceptableThe requested response type is not supported by the client. |
| 429 |
Too many requests Too many requests within a certain time frame. To know more about api call limits, click here. |
| 500 |
Server errorZoho Billing' server encountered an error which prevents it from fulfilling the request. Although this rarely happens, we recommend you to contact us at support@zohobilling.com if you receive this error. |
$ curl https://www.zohoapis.com/billing/v1/invoices/700000007942 \
-H 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
-H 'X-com-zoho-subscriptions-organizationid: 10234695'
Response Example
{
"code": 0,
"message": "Successfully created."
}
Response Example
{
"code": 1002,
"message": "Invoice does not exist."
}
Response Example
{
"code": 1000,
"message": "Internal error"
}
