Response
Responses will be in the JSON format.
| Node Name | Description |
|---|---|
| code | Zoho Books error code. This will be zero for a success response and non-zero in case of an error. |
| message | Message for the invoked API. |
| resource name | Comprises the invoked API’s Data. |
Other Formats
Certain APIs also support csv and pdf formats. The required response format needs to be specified in the respective request’s Accept header or accept query parameter.
Date
All timestamps are returned in the ISO 8601 format - YYYY-MM-DDThh:mm:ssTZD.
Example: 2016-06-11T17:38:06-0700
$ curl https://www.zohoapis.com/books/v3/invoices/7000000079426?organization_id=10234695
-H 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
-H 'Accept: application/pdf'
OR
$ curl https://www.zohoapis.com/books/v3/invoices/7000000079426?accept=pdf \'&organization_id=10234695'
-H 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
The response structure for the Books API follows the below format.
{
"code" : 0,
"message" : "success",
"invoice" : {
"invoice_id" : "..."
}
}
HTTP/1.1 200 OK
Content-Disposition: attachment; filename="INV-384.pdf"
Content-Type: application/pdf;charset=UTF-8