Chart Of Accounts

The Chart of Accounts in Zoho Books consists of a wide range of accounts that are generally used with any type of business. The accounts are classified into different types such as Income, Expense, Equity, Liability & Assets.

Download Chart Of Accounts OpenAPI Document

End Points

POST

/chartofaccounts/{account_id}

GET

/chartofaccounts/{account_id}

DELETE

/chartofaccounts/{account_id}

POST

/chartofaccounts/{account_id}/active

POST

/chartofaccounts/{account_id}/inactive

GET

/chartofaccounts/transactions

DELETE

/chartofaccounts/transactions/{transaction_id}

Attribute

account_id

string

ID of the Account

account_name

string

Name of the account

account_code

string

Code Associated with the Account

is_active

boolean

Check if account is Active or Inactive

account_type

string

Type of the account. Allowed Values: other_asset, other_current_asset, intangible_asset, right_to_use_asset,financial_asset,contingent_asset,contract_asset, cash, bank, fixed_asset, other_current_liability, contract_liability , refund_liability, credit_card, long_term_liability, loans_and_borrowing ,lease_liability ,employee_benefit_liability ,contingent_liability ,financial_liability , other_liability, equity, income,finance_income ,other_comprehensive_income , other_income, expense, manufacturing_expense ,impairment_expense ,depreciation_expense ,employee_benefit_expense ,lease_expense ,finance_expense ,tax_expense , cost_of_goods_sold, other_expense, accounts_receivable and accounts_payable.

currency_id

string

ID of the account currency.

currency_code

string

Code of the Currency Associated with the Account

description

string

Description of the account

is_system_account

boolean

Check if it is an System Account

is_involved_in_transaction

boolean

Check if account is involved in transaction

can_show_in_ze

boolean

include_in_vat_return

boolean

🇬🇧 only

Boolean to include an account in VAT returns.

custom_fields

array

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

parent_account_id

string

ID of the Parent Account

documents

array

created_time

string

Created Time associated with the Entity

last_modified_time

string

Last Modified time associated with the entity

{
    "account_id": "460000000038079",
    "account_name": "Notes Payable",
    "account_code": "string",
    "is_active": true,
    "account_type": "long_term_liability",
    "currency_id": "460000000000097",
    "currency_code": "INR",
    "description": "A Liability account which can be paid off in a time period longer than one year.",
    "is_system_account": true,
    "is_involved_in_transaction": false,
    "can_show_in_ze": false,
    "include_in_vat_return": true,
    "custom_fields": [
        {
            "customfield_id": "460000000080163",
            "value": "Normal"
        }
    ],
    "parent_account_id": "460000000009097",
    "documents": [
        "string"
    ],
    "created_time": "2013-01-17T15:27:23+0530",
    "last_modified_time": "2013-01-17T15:27:23+0530"
}

Creates an account with the given account type.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

account_name

string

Name of the account

account_code

string

Code Associated with the Account

account_type

string

currency_id

string

ID of the account currency.

description

string

Description of the account

show_on_dashboard

boolean

can_show_in_ze

boolean

include_in_vat_return

boolean

🇬🇧 only

Boolean to include an account in VAT returns.

custom_fields

array

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

parent_account_id

string

ID of the Parent Account

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

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/chartofaccounts?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;

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/chartofaccounts?organization_id=10234695")
  .post(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

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/chartofaccounts?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

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/chartofaccounts?organization_id=10234695", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts?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 --request POST \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "account_name": "Notes Payable",
    "account_code": "string",
    "account_type": "long_term_liability",
    "currency_id": "460000000000097",
    "description": "A Liability account which can be paid off in a time period longer than one year.",
    "show_on_dashboard": false,
    "can_show_in_ze": false,
    "include_in_vat_return": true,
    "custom_fields": [
        {
            "customfield_id": "460000000080163",
            "value": "Normal"
        }
    ],
    "parent_account_id": "460000000009097"
}

{
    "code": 0,
    "message": "The account has been created.",
    "chart_of_account": {
        "account_id": "460000000038079",
        "account_name": "Notes Payable",
        "account_code": "string",
        "is_active": true,
        "account_type": "long_term_liability",
        "currency_id": "460000000000097",
        "currency_code": "INR",
        "description": "A Liability account which can be paid off in a time period longer than one year.",
        "is_system_account": true,
        "is_involved_in_transaction": false,
        "can_show_in_ze": false,
        "include_in_vat_return": true,
        "custom_fields": [
            {
                "customfield_id": "460000000080163",
                "value": "Normal"
            }
        ],
        "parent_account_id": "460000000009097",
        "documents": [
            "string"
        ],
        "created_time": "2013-01-17T15:27:23+0530",
        "last_modified_time": "2013-01-17T15:27:23+0530"
    }
}

List all chart of accounts along with pagination.
OAuth Scope : ZohoBooks.accountants.READ

Query Parameters

organization_id

string

(Required)

ID of the organization

showbalance

boolean

Boolean to get current balance of accounts.

filter_by

string

Filter accounts based on its account type and status. Allowed Values: AccountType.All, AccountType.Active, AccountType.Inactive, AccountType.Asset, AccountType.Liability, AccountType.Equity, AccountType.Income and AccountType.Expense.

sort_column

string

Sort accounts. Allowed Values: account_name and account_type.

last_modified_time

string

page

integer

Page number to be fetched. Default value is 1.

per_page

integer

Number of records to be fetched per page. Default value is 200.

Request Example

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

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/chartofaccounts?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/books/v3/chartofaccounts?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts?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 --request GET \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "chartofaccounts": [
        {
            "account_id": "460000000038079",
            "account_name": "Notes Payable",
            "account_code": "string",
            "account_type": "long_term_liability",
            "is_user_created": true,
            "is_system_account": true,
            "is_standalone_account": false,
            "is_active": true,
            "can_show_in_ze": false,
            "is_involved_in_transaction": false,
            "current_balance": null,
            "parent_account_id": "460000000009097",
            "parent_account_name": " ",
            "depth": "string",
            "has_attachment": false,
            "is_child_present": "string",
            "child_count": "string",
            "documents": [
                "string"
            ],
            "created_time": "2013-01-17T15:27:23+0530",
            "last_modified_time": "2013-01-17T15:27:23+0530"
        },
        {...},
        {...}
    ]
}

Updates the account information.
OAuth Scope : ZohoBooks.accountants.UPDATE

Arguments

account_name

string

Name of the account

account_code

string

Code Associated with the Account

account_type

string

currency_id

string

ID of the account currency.

description

string

Description of the account

show_on_dashboard

boolean

can_show_in_ze

boolean

include_in_vat_return

boolean

🇬🇧 only

Boolean to include an account in VAT returns.

custom_fields

array

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

parent_account_id

string

ID of the Parent Account

Path Parameters

account_id

string

(Required)

Unique identifier of the account.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

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/chartofaccounts/460000000038079?organization_id=10234695"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;

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/chartofaccounts/460000000038079?organization_id=10234695")
  .put(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'PUT',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

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("PUT", "/books/v3/chartofaccounts/460000000038079?organization_id=10234695", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "PUT",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts/460000000038079?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 --request PUT \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "account_name": "Notes Payable",
    "account_code": "string",
    "account_type": "long_term_liability",
    "currency_id": "460000000000097",
    "description": "A Liability account which can be paid off in a time period longer than one year.",
    "show_on_dashboard": false,
    "can_show_in_ze": false,
    "include_in_vat_return": true,
    "custom_fields": [
        {
            "customfield_id": "460000000080163",
            "value": "Normal"
        }
    ],
    "parent_account_id": "460000000009097"
}

{
    "code": 0,
    "message": "The details of the account have been updated.",
    "chart_of_account": {
        "account_id": "460000000038079",
        "account_name": "Notes Payable",
        "account_code": "string",
        "is_active": true,
        "account_type": "long_term_liability",
        "currency_id": "460000000000097",
        "currency_code": "INR",
        "description": "A Liability account which can be paid off in a time period longer than one year.",
        "is_system_account": true,
        "is_involved_in_transaction": false,
        "can_show_in_ze": false,
        "include_in_vat_return": true,
        "custom_fields": [
            {
                "customfield_id": "460000000080163",
                "value": "Normal"
            }
        ],
        "parent_account_id": "460000000009097",
        "documents": [
            "string"
        ],
        "created_time": "2013-01-17T15:27:23+0530",
        "last_modified_time": "2013-01-17T15:27:23+0530"
    }
}

Gets the details of an account.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

account_id

string

(Required)

Unique identifier of the account.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

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

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/books/v3/chartofaccounts/460000000038079?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts/460000000038079?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 --request GET \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "account_id": "460000000038079",
    "account_name": "Notes Payable",
    "account_code": "string",
    "is_active": true,
    "account_type": "long_term_liability",
    "currency_id": "460000000000097",
    "currency_code": "INR",
    "description": "A Liability account which can be paid off in a time period longer than one year.",
    "is_system_account": true,
    "is_involved_in_transaction": false,
    "can_show_in_ze": false,
    "include_in_vat_return": true,
    "custom_fields": [
        {
            "customfield_id": "460000000080163",
            "value": "Normal"
        }
    ],
    "closing_balance": 0,
    "parent_account_id": "460000000009097",
    "documents": [
        "string"
    ],
    "created_time": "2013-01-17T15:27:23+0530",
    "last_modified_time": "2013-01-17T15:27:23+0530"
}

Deletes the given account. Accounts associated in any transaction/products could not be deleted.
OAuth Scope : ZohoBooks.accountants.DELETE

Path Parameters

account_id

string

(Required)

Unique identifier of the account.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

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

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695")
  .delete(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("DELETE", "/books/v3/chartofaccounts/460000000038079?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "DELETE",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts/460000000038079?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 --request DELETE \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The account has been deleted."
}

Updates the account status as active.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

account_id

string

(Required)

Unique identifier of the account.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

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

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079/active?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079/active?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("POST", "/books/v3/chartofaccounts/460000000038079/active?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts/460000000038079/active?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 --request POST \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079/active?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The account has been marked as active."
}

Updates the account status as inactive.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

account_id

string

(Required)

Unique identifier of the account.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

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

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079/inactive?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079/inactive?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("POST", "/books/v3/chartofaccounts/460000000038079/inactive?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts/460000000038079/inactive?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 --request POST \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts/460000000038079/inactive?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The account has been marked as inactive."
}

List all involved transactions for the given account.
OAuth Scope : ZohoBooks.accountants.READ

Query Parameters

organization_id

string

(Required)

ID of the organization

account_id

string

(Required)

ID of the Account

date

string

Search account transactions with the given date range. Default date format is yyyy-mm-dd. Variants: date.start, date.end, date.before and date.after.

amount

double

Search account transactions with given amount range. Variants: amount.less_than, amount.less_equals, amount.greater_than and amount.greater_equals.

filter_by

string

transaction_type

string

Search transactions based on the given transaction type. Allowed Values: invoice, customer_payment, bills, vendor_payment, credit_notes, creditnote_refund, expense, card_payment, purchase_or_charges, journal, deposit, refund, transfer_fund, base_currency_adjustment, opening_balance, sales_without_invoices, expense_refund, tax_refund, receipt_from_initial_debtors, owner_contribution, interest_income, other_income, owner_drawings and payment_to_initial_creditors.

sort_column

string

Sort accounts. Allowed Values: account_name and account_type.

page

integer

Page number to be fetched. Default value is 1.

per_page

integer

Number of records to be fetched per page. Default value is 200.

Request Example

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

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/chartofaccounts/transactions?organization_id=10234695&account_id=460000000038079")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts/transactions?organization_id=10234695&account_id=460000000038079', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/books/v3/chartofaccounts/transactions?organization_id=10234695&account_id=460000000038079", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts/transactions?organization_id=10234695&account_id=460000000038079",
  "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 --request GET \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts/transactions?organization_id=10234695&account_id=460000000038079' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "transactions": [
        {
            "categorized_transaction_id": "460000000052051",
            "transaction_type": "customer_payment",
            "transaction_status": "string",
            "transaction_source": "string",
            "transaction_id": "460000000050163",
            "transaction_date": "2013-10-04",
            "account_id": "460000000038079",
            "customer_id": "460000000044001",
            "payee": "Richards Electric Company",
            "description": "A Liability account which can be paid off in a time period longer than one year.",
            "entry_number": "INV-00004",
            "currency_id": "460000000000097",
            "currency_code": "INR",
            "debit_or_credit": "credit",
            "offset_account_name": "string",
            "reference_number": "string",
            "reconcile_status": "string",
            "debit_amount": "string",
            "credit_amount": 25
        },
        {...},
        {...}
    ]
}

Deletes the transaction.
OAuth Scope : ZohoBooks.accountants.DELETE

Path Parameters

transaction_id

string

(Required)

Unique identifier of the transaction.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

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

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/chartofaccounts/transactions/460000000050163?organization_id=10234695")
  .delete(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/chartofaccounts/transactions/460000000050163?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("DELETE", "/books/v3/chartofaccounts/transactions/460000000050163?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "DELETE",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/chartofaccounts/transactions/460000000050163?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 --request DELETE \
  --url 'https://www.zohoapis.com/books/v3/chartofaccounts/transactions/460000000050163?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The transaction has been deleted."
}

Attribute

Create an account

Arguments

Query Parameters

List chart of accounts

Query Parameters

Update an account

Arguments

Path Parameters

Query Parameters

Get an account

Path Parameters

Query Parameters

Delete an account

Path Parameters

Query Parameters

Mark an account as active

Path Parameters

Query Parameters

Mark an account as inactive

Path Parameters

Query Parameters

List of transactions for an account

Query Parameters

Delete a transaction

Path Parameters

Query Parameters