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"
}

Create an account

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 chart of accounts

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"
        },
        {...},
        {...}
    ]
}

Update an account

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"
    }
}

Get an account

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"
}

Delete an account

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."
}

Mark an account as active

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."
}

Mark an account as inactive

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 of transactions for an account

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
        },
        {...},
        {...}
    ]
}

Delete a transaction

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."
}