API Docs
No Results Found


Zoho Books 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
200 OK
201 Created
400 Bad request
401 Unauthorized (Invalid AuthToken)
404 URL Not Found
405 Method Not Allowed (Method you have called is not supported for the invoked API)
429 Rate Limit Exceeded (API usage limit exceeded)
500 Internal Error

Request Example

Click to copy
$ curl https://books.zoho.com/api/v3/invoices/700000007942?organization_id=10234695 -H 'Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

Response Example

{ "code": 0, "message": "Successfully created." }

Response Example

{ "code": 1002, "message": "Invoice does not exist." }

Response Example

{ "code": 1000, "message": "Internal error" }