Zoho Books API

https://www.zoho.com/books/api/v3/
Admin
The Zoho Books API provides a comprehensive set of endpoints for integrating with and managing...
Tokens:870,383
Snippets:3,582
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### Response Example

Source: https://www.zoho.com/books/api/v3/time-entries

JSON response structure returned upon successfully starting the timer.

```json
{ "code": 0, "message": "The timer has been started.", "time_entry": { "time_entry_id": "460000000044021", "project_id": "460000000044019", "project_name": "REAL TIME TRAFFIC FLUX", "customer_id": "460000000044001", "customer_name": "SAF Instruments Inc", "task_id": "460000000044009", "task_name": "Distribution Analysis", "user_id": "460000000024003", "user_name": "John David", "is_current_user": true, "log_date": "2013-09-17", "begin_time": "03:00", "end_time": "04:00", "log_time": "05:00", "is_billable": true, "billed_status": "unbilled", "invoice_id": "", "notes": " ", "timer_started_at": " ", "timer_started_at_utc_time": "", "timer_duration_in_minutes": " ", "timer_duration_in_seconds": "", "created_time": "2013-09-18T18:05:27+0530", "timesheet_custom_fields": "" } }
```

--------------------------------

### Get Bill Details Request Examples

Source: https://www.zoho.com/books/api/v3/bills

Examples for retrieving bill details across various programming languages and tools.

```Deluge
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/bills/460000000098765?organization_id=10234695" type: GET headers: headers_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/bills/460000000098765?organization_id=10234695") .get() .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' } }; fetch('https://www.zohoapis.com/books/v3/bills/460000000098765?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }  conn.request("GET", "/books/v3/bills/460000000098765?organization_id=10234695", headers=headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "GET", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/bills/460000000098765?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.end();
```

```cURL
curl --request GET \
 --url 'https://www.zohoapis.com/books/v3/bills/460000000098765?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Retrieve Item Details Request Examples

Source: https://www.zoho.com/books/api/v3/items

Examples for making a GET request to the itemdetails endpoint across various programming languages.

```Deluge
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/itemdetails?item_ids=4815000000044208,4815000000044274,4815000000044340&organization_id=10234695" type: GET headers: headers_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/itemdetails?item_ids=4815000000044208%2C4815000000044274%2C4815000000044340&organization_id=10234695") .get() .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' } }; fetch('https://www.zohoapis.com/books/v3/itemdetails?item_ids=4815000000044208%2C4815000000044274%2C4815000000044340&organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }  conn.request("GET", "/books/v3/itemdetails?item_ids=4815000000044208%2C4815000000044274%2C4815000000044340&organization_id=10234695", headers=headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "GET", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/itemdetails?item_ids=4815000000044208%2C4815000000044274%2C4815000000044340&organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.end();
```

```cURL
curl --request GET \
 --url 'https://www.zohoapis.com/books/v3/itemdetails?item_ids=4815000000044208%2C4815000000044274%2C4815000000044340&organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Create Opening Balance Request Examples

Source: https://www.zoho.com/books/api/v3/opening-balance

Examples showing how to perform a POST request to the opening balances endpoint across different programming environments.

```Deluge
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/settings/openingbalances?organization_id=10234695" type: POST headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/settings/openingbalances?organization_id=10234695") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.com/books/v3/settings/openingbalances?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" }  conn.request("POST", "/books/v3/settings/openingbalances?organization_id=10234695", payload, headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "POST", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/settings/openingbalances?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
```

```cURL
curl --request POST \
 --url 'https://www.zohoapis.com/books/v3/settings/openingbalances?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
 --header 'content-type: application/json' \
 --data '{"field1":"value1","field2":"value2"}'
```

--------------------------------

### Delete a contact document request examples

Source: https://www.zoho.com/books/api/v3/contacts

Examples for performing a GET request to delete a document attached to a contact.

```Deluge
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/contacts/460000000026049/documents/460000000123001?organization_id=10234695" type: GET headers: headers_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/contacts/460000000026049/documents/460000000123001?organization_id=10234695") .get() .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' } }; fetch('https://www.zohoapis.com/books/v3/contacts/460000000026049/documents/460000000123001?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }  conn.request("GET", "/books/v3/contacts/460000000026049/documents/460000000123001?organization_id=10234695", headers=headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "GET", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/contacts/460000000026049/documents/460000000123001?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.end();
```

```cURL
curl --request GET \ --url 'https://www.zohoapis.com/books/v3/contacts/460000000026049/documents/460000000123001?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Create a User Request Examples

Source: https://www.zoho.com/books/api/v3/users

Examples for creating a new user in an organization using various programming languages.

```Deluge
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/users?organization_id=10234695" type: POST headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/users?organization_id=10234695") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.com/books/v3/users?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" }  conn.request("POST", "/books/v3/users?organization_id=10234695", payload, headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "POST", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/users?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
```

```cURL
curl --request POST \
 --url 'https://www.zohoapis.com/books/v3/users?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
 --header 'content-type: application/json' \
 --data '{"field1":"value1","field2":"value2"}'
```

--------------------------------

### Create Project Task Request Examples

Source: https://www.zoho.com/books/api/v3/projects

Examples for sending a POST request to create a task in a project across multiple programming languages.

```Deluge
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/projects/90300000072369/tasks?organization_id=10234695" type: POST headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/projects/90300000072369/tasks?organization_id=10234695") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.com/books/v3/projects/90300000072369/tasks?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" }  conn.request("POST", "/books/v3/projects/90300000072369/tasks?organization_id=10234695", payload, headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "POST", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/projects/90300000072369/tasks?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
```

```cURL
curl --request POST \
 --url 'https://www.zohoapis.com/books/v3/projects/90300000072369/tasks?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
 --header 'content-type: application/json' \
 --data '{"field1":"value1","field2":"value2"}'
```

--------------------------------

### Create Contact Request Examples

Source: https://www.zoho.com/books/api/v3/contacts

Examples demonstrating how to perform a POST request to the contacts endpoint using various programming languages.

```Deluge
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/contacts?organization_id=10234695" type: POST headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/contacts?organization_id=10234695") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.com/books/v3/contacts?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" }  conn.request("POST", "/books/v3/contacts?organization_id=10234695", payload, headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "POST", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/contacts?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
```

```cURL
curl --request POST \
 --url 'https://www.zohoapis.com/books/v3/contacts?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
 --header 'content-type: application/json' \
 --data '{"field1":"value1","field2":"value2"}'
```

--------------------------------

### Retrieve Contact Address Request Examples

Source: https://www.zoho.com/books/api/v3/contacts

Examples for performing a GET request to retrieve contact addresses across various programming languages.

```Deluge
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/contacts/460000000026049/address?organization_id=10234695" type: GET headers: headers_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/contacts/460000000026049/address?organization_id=10234695") .get() .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' } }; fetch('https://www.zohoapis.com/books/v3/contacts/460000000026049/address?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }  conn.request("GET", "/books/v3/contacts/460000000026049/address?organization_id=10234695", headers=headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "GET", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/contacts/460000000026049/address?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.end();
```

```cURL
curl --request GET \
 --url 'https://www.zohoapis.com/books/v3/contacts/460000000026049/address?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Retrieve Bulk History Request Examples

Source: https://www.zoho.com/books/api/v3/registers

Examples for making a GET request to the bulk history endpoint across various programming languages.

```Deluge
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/registers/460000000038079/bulkhistory/460000000050041?organization_id=10234695" type: GET headers: headers_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/registers/460000000038079/bulkhistory/460000000050041?organization_id=10234695") .get() .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' } }; fetch('https://www.zohoapis.com/books/v3/registers/460000000038079/bulkhistory/460000000050041?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }  conn.request("GET", "/books/v3/registers/460000000038079/bulkhistory/460000000050041?organization_id=10234695", headers=headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "GET", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/registers/460000000038079/bulkhistory/460000000050041?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.end();
```

```cURL
curl --request GET \
 --url 'https://www.zohoapis.com/books/v3/registers/460000000038079/bulkhistory/460000000050041?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
```

--------------------------------

### Create a Bill Request Examples

Source: https://www.zoho.com/books/api/v3/bills

Examples demonstrating how to create a bill using various programming languages and tools. Ensure the organization_id and authorization token are correctly configured for your environment.

```Deluge
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/bills?organization_id=10234695" type: POST headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/bills?organization_id=10234695") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.com/books/v3/bills?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" }  conn.request("POST", "/books/v3/bills?organization_id=10234695", payload, headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "POST", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/bills?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
```

```cURL
curl --request POST \
 --url 'https://www.zohoapis.com/books/v3/bills?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
 --header 'content-type: application/json' \
 --data '{"field1":"value1","field2":"value2"}'
```

--------------------------------

### Create Estimate Request Examples

Source: https://www.zoho.com/books/api/v3/estimates

Examples demonstrating how to send a POST request to the estimates endpoint using various programming languages and tools.

```Deluge
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/books/v3/estimates?organization_id=10234695" type: POST headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
```

```Java
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.com/books/v3/estimates?organization_id=10234695") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
```

```Javascript
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.com/books/v3/estimates?organization_id=10234695', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
```

```Python
import http.client  conn = http.client.HTTPSConnection("www.zohoapis.com")  payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"  headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" }  conn.request("POST", "/books/v3/estimates?organization_id=10234695", payload, headers)  res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
```

```Node.js
const http = require("https"); const options = { "method": "POST", "hostname": "www.zohoapis.com", "port": null, "path": "/books/v3/estimates?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; const req = http.request(options, function (res) { const chunks = [];    res.on("data", function (chunk) {     chunks.push(chunk); });    res.on("end", function () { const body = Buffer.concat(chunks);     console.log(body.toString()); }); });  req.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
```

```cURL
curl --request POST \
 --url 'https://www.zohoapis.com/books/v3/estimates?organization_id=10234695' \
 --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
 --header 'content-type: application/json' \
 --data '{"field1":"value1","field2":"value2"}'
```

--------------------------------

### Get Bill Details Response Example

Source: https://www.zoho.com/books/api/v3/bills

JSON response structure for a successful bill retrieval request.

```json
{ "code": 0, "message": "success", "bill": { "bill_id": "460000000098765", "purchaseorder_ids": [ 460000000068231, 460000000068233 ], "vendor_id": "460000000038029", "vendor_name": "string", "vat_treatment": "string", "vat_reg_no": "string", "source_of_supply": "AP", "destination_of_supply": "TN", "place_of_supply": "DU", "permit_number": "string", "gst_no": "22AAAAA0000A1Z5", "gst_treatment": "business_gst", "tax_treatment": "vat_registered", "is_pre_gst": false, "pricebook_id": 460000000038090, "pricebook_name": "string", "is_reverse_charge_applied": true, "unused_credits_payable_amount": 187, "status": "open", "bill_number": "00454", "date": "2013-09-11", "due_date": "2013-09-26", "payment_terms": 0, "payment_terms_label": "Due on Receipt", "payment_expected_date": "string", "reference_number": "4321133", "recurring_bill_id": "string", "due_by_days": "string", "due_in_days": 0, "currency_id": "460000000000099", "currency_code": "INR", "currency_symbol": "string", "documents": [ { "document_id": "string", "file_name": "string" } ], "price_precision": 2, "exchange_rate": 1.23, "adjustment": 0, "adjustment_description": " ", "custom_fields": [ { "custom_field_id": "string", "index": 0, "label": "string", "value": "string" } ], "tags": [ { "tag_id": "460000000000567", "tag_name": "Business Unit", "tag_option_id": "460000000014044", "tag_option_name": "Sales", "is_tag_mandatory": false } ], "is_tds_applied": true, "is_item_level_tax_calc": false, "is_inclusive_tax": false, "filed_in_vat_return_id": "string", "filed_in_vat_return_name": "string", "filed_in_vat_return_type": "string", "is_abn_quoted": "string", "line_items": [ { "purchaseorder_item_id": "string", "line_item_id": "460000000067009", "item_id": "460000000054135", "sku": "string", "name": "string", "account_id": "460000000000403", "account_name": "Other Expenses", "image_document_id": 460000000038067, "location_id": "460000000038080", "location_name": "string", "reverse_charge_tax_id": 460000000038056, "reverse_charge_tax_name": "inter", "reverse_charge_tax_percentage": 10, "reverse_charge_tax_amount": 100, "description": "string", "bcy_rate": 40, "rate": 10, "tags": [ { "tag_id": "460000000000567", "tag_option_id": "460000000014044" } ], "line_item_category": "line_item", "quantity": 1, "tax_id": "460000000027005"
```
Tokens:
Raw