Registers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Account register APIs for chart of accounts: list register transactions, bulk update or delete transactions, bulk action history, budget vs actuals, and bulk update field metadata.

Download Registers OpenAPI Document

End Points

GET

/registers/{account_id}/transactions

GET

/registers/{account_id}/bulkhistory

GET

/registers/{account_id}/bulkhistory/{comment_id}

GET

/registers/{account_id}/bulkupdate/editpage

GET

/registers/{account_id}/budgetvsactuals

PUT

/registers/{account_id}/transactions/bulkupdate

PUT

/registers/{account_id}/transactions/bulkdelete

Attribute

bulk_action_id

string

ID of the bulk action history record.

account_id

string

ID of the chart of accounts account.

description

string

Description of the bulk action.

action_type

string

Type of bulk action performed.

status

string

Status of the bulk action or entity update.

date

string

Date and time of the bulk action.

user_id

string

ID of the user who performed the bulk action.

user_name

string

Name of the user who performed the bulk action.

txn_count

string

Number of transactions affected.

updated_field

string

Field that was updated in the bulk action.

updated_value

string

Value applied in the bulk update.

updated_reason

string

Reason provided for the bulk update.

{
    "bulk_action_id": "460000000050041",
    "account_id": "460000000038079",
    "description": "Bulk update on register transactions",
    "action_type": "bulk_update",
    "status": "completed",
    "date": "2026-05-22T10:30:00+0530",
    "user_id": "460000000000026",
    "user_name": "John Smith",
    "txn_count": "5",
    "updated_field": "account_id",
    "updated_value": "460000000038080",
    "updated_reason": "Correction"
}

List register transactions AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Retrieve transactions for a chart of accounts register (account) as a report view with optional grouping, column selection, and print preferences.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

account_id

string

(Required)

Unique identifier of the chart of accounts register (general ledger account).

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

filter_by

string

Filter transactions by date. Allowed Values: TransactionDate.Today, TransactionDate.ThisWeek, TransactionDate.ThisMonth, TransactionDate.ThisQuarter, TransactionDate.ThisYear, TransactionDate.PreviousDay, TransactionDate.PreviousWeek, TransactionDate.PreviousMonth, TransactionDate.PreviousQuarter, TransactionDate.PreviousYear, and TransactionDate.CustomDate.

from_date

date

Start date when using a custom date range. Format yyyy-mm-dd.

to_date

date

End date when using a custom date range. Format yyyy-mm-dd.

cash_based

boolean

When true, returns cash-based amounts.

account_id

string

Comma-separated account IDs to include (max 50).

group_by

string

JSONArray of report select columns for grouping.

sort_column

string

Sort column. Allowed Values: date, transaction_type, account_type, account_name, and account_code.

optional_columns

string

Optional columns to include. Allowed Values: account_code, running_balance, and net_amount (comma-separated).

show_fcy

boolean

When true, includes foreign currency amounts.

is_select_column_enabled

boolean

When true, enables select-column report flow.

is_new_flow

boolean

When true, uses the new report pipeline.

is_account_code_column_enabled

boolean

When true, includes the account code column.

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 10.

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/registers/460000000038079/transactions?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/registers/460000000038079/transactions?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/registers/460000000038079/transactions?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/registers/460000000038079/transactions?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/registers/460000000038079/transactions?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/registers/460000000038079/transactions?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "register_transactions": {
        "account_transactions": [
            {
                "transaction_id": "460000000050163",
                "transaction_date": "2026-05-15",
                "transaction_type": "invoice",
                "transaction_type_formatted": "Invoice",
                "account_id": "460000000038079",
                "debit_amount": 100,
                "credit_amount": 0
            }
        ],
        "account_type": "expense",
        "gl_closing_balance": 12500
    },
    "page_context": {
        "page": 1,
        "per_page": 10,
        "has_more_page": false,
        "report_name": "zb.reports.bulkaction.history.list",
        "applied_filter": "",
        "sort_column": "created_time",
        "sort_order": "D"
    }
}

List register bulk action history AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List bulk update and bulk delete history for the given account register.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

account_id

string

(Required)

Unique identifier of the chart of accounts register (general ledger account).

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

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 10.

sort_column

string

Sort column. Allowed Values: created_time.

sort_order

string

Sort order. Allowed Values: A and D.

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/registers/460000000038079/bulkhistory?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/registers/460000000038079/bulkhistory?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/registers/460000000038079/bulkhistory?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/registers/460000000038079/bulkhistory?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/registers/460000000038079/bulkhistory?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/registers/460000000038079/bulkhistory?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "bulk_actions_history": [
        {
            "bulk_action_id": "460000000050041",
            "account_id": "460000000038079",
            "description": "Bulk update on register transactions",
            "action_type": "bulk_update",
            "status": "completed",
            "date": "2026-05-22T10:30:00+0530",
            "user_id": "460000000000026",
            "user_name": "John Smith",
            "txn_count": "5",
            "updated_field": "account_id",
            "updated_value": "460000000038080",
            "updated_reason": "Correction"
        },
        {...},
        {...}
    ],
    "page_context": {
        "page": 1,
        "per_page": 10,
        "has_more_page": false,
        "report_name": "zb.reports.bulkaction.history.list",
        "applied_filter": "",
        "sort_column": "created_time",
        "sort_order": "D"
    }
}

Get register bulk action history details AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Retrieve details of a single bulk action on the account register, including affected transactions.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

account_id

string

(Required)

Unique identifier of the chart of accounts register (general ledger account).

comment_id

string

(Required)

Unique identifier of the bulk action history comment.

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

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 10.

sort_column

string

Sort column. Allowed Values: created_time.

sort_order

string

Sort order. Allowed Values: A and D.

Request Example

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;

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();

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));

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

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 --request GET \
  --url 'https://www.zohoapis.com/books/v3/registers/460000000038079/bulkhistory/460000000050041?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "bulk_action_details": {
        "bulk_action_id": "460000000050041",
        "action_type": "bulk_update",
        "account_id": "460000000038079",
        "account_name": "Petty Cash",
        "description": "Bulk update on register transactions",
        "status": "completed",
        "date": "2026-05-22T10:30:00+0530",
        "updated_field": "account_id",
        "updated_value": "460000000038080",
        "updated_reason": "Correction",
        "transactions": [
            {
                "entity_id": "460000000050163",
                "transaction_number": "INV-00042",
                "transaction_type": "invoice",
                "entity_status": "success"
            }
        ]
    },
    "page_context": {
        "page": 1,
        "per_page": 10,
        "has_more_page": false,
        "report_name": "zb.reports.bulkaction.history.list",
        "applied_filter": "",
        "sort_column": "created_time",
        "sort_order": "D"
    }
}

Get register bulk update edit page AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Returns metadata for fields supported when bulk updating transactions on an account register.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

account_id

string

(Required)

Unique identifier of the chart of accounts register (general ledger account).

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/registers/460000000038079/bulkupdate/editpage?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/registers/460000000038079/bulkupdate/editpage?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/registers/460000000038079/bulkupdate/editpage?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/registers/460000000038079/bulkupdate/editpage?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/registers/460000000038079/bulkupdate/editpage?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/registers/460000000038079/bulkupdate/editpage?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "fields": [
        {
            "can_show_field": true,
            "data_type": "date",
            "field": "date",
            "label": "Date",
            "option_label": "name",
            "option_value": "id",
            "values": [
                {...}
            ]
        },
        {...},
        {...}
    ]
}

Get register budget vs actuals AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Retrieve budget versus actuals for an account register. When budget_id is provided, returns detailed period breakdown.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

account_id

string

(Required)

Unique identifier of the chart of accounts register (general ledger account).

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

budget_id

string

ID of the budget. When provided, returns detailed budget_vs_actuals for that budget.

filter_by

string

Filter by transaction date. Allowed Values: TransactionDate.Today, TransactionDate.ThisWeek, TransactionDate.ThisMonth, TransactionDate.ThisQuarter, TransactionDate.ThisYear, TransactionDate.PreviousDay, TransactionDate.PreviousWeek, TransactionDate.PreviousMonth, TransactionDate.PreviousQuarter, TransactionDate.PreviousYear, and TransactionDate.CustomDate.

cash_based

boolean

When true, uses cash-based accounting.

from_date

date

Start date for the comparison period. Format yyyy-mm-dd.

to_date

date

End date for the comparison period. Format yyyy-mm-dd.

period

string

Period granularity. Allowed Values: monthly, half-yearly, yearly, and quarterly. Default value is monthly.

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/registers/460000000038079/budgetvsactuals?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/registers/460000000038079/budgetvsactuals?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/registers/460000000038079/budgetvsactuals?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/registers/460000000038079/budgetvsactuals?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/registers/460000000038079/budgetvsactuals?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/registers/460000000038079/budgetvsactuals?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "register_budget_vs_actual": {
        "budget_info_list": [
            {
                "budget_id": "460000000991001",
                "budget_name": "FY 2026 Operating Budget"
            }
        ],
        "budget_vs_actuals": {
            "generalledger_info": {
                "generalledger_id": "460000000038079",
                "generalledger_name": "Office Supplies"
            },
            "budget_info": {
                "budget_id": "460000000991001",
                "budget_name": "FY 2026 Operating Budget"
            },
            "detailed_budget_vs_actual": [
                {...}
            ]
        }
    }
}

Bulk update register transactions AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Bulk update transactions on the account register (for example, change account, branch, or date on selected entities).
OAuth Scope : ZohoBooks.accountants.UPDATE

Arguments

account_id

string

ID of the chart of accounts account.

branch_id

string

ID of the branch or location.

date

string

Date and time of the bulk action.

bulk_update_reason

string

Reason for the bulk update.

entities

array

list of json object with contains entity id and Type of entity.

Show Sub-Attributes

entity_id

string

ID of the entity (transaction source record).

entity_type

string

Type of entity. Examples include invoice, bill, journal, and expense.

Path Parameters

account_id

string

(Required)

Unique identifier of the chart of accounts register (general ledger account).

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

from_account_id

boolean

When true, indicates the update is initiated from another account context.

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/registers/460000000038079/transactions/bulkupdate?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/registers/460000000038079/transactions/bulkupdate?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/registers/460000000038079/transactions/bulkupdate?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/registers/460000000038079/transactions/bulkupdate?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/registers/460000000038079/transactions/bulkupdate?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/registers/460000000038079/transactions/bulkupdate?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "account_id": "460000000038079",
    "branch_id": "460000000000364",
    "date": "2026-05-22T10:30:00+0530",
    "bulk_update_reason": "Correction",
    "entities": [
        {
            "entity_id": "460000000050163",
            "entity_type": "invoice"
        }
    ]
}

{
    "code": 0,
    "message": "Bulk update completed."
}

Bulk delete register transactions AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Bulk delete selected transactions on the account register.
OAuth Scope : ZohoBooks.accountants.UPDATE

Path Parameters

account_id

string

(Required)

Unique identifier of the chart of accounts register (general ledger account).

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

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/registers/460000000038079/transactions/bulkdelete?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/registers/460000000038079/transactions/bulkdelete?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/registers/460000000038079/transactions/bulkdelete?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/registers/460000000038079/transactions/bulkdelete?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/registers/460000000038079/transactions/bulkdelete?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/registers/460000000038079/transactions/bulkdelete?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "account_id": "460000000038079",
    "branch_id": "460000000000364",
    "date": "2026-05-22T10:30:00+0530",
    "bulk_update_reason": "Correction",
    "entities": [
        {
            "entity_id": "460000000050163",
            "entity_type": "invoice"
        }
    ]
}

{
    "code": 0,
    "message": "Bulk delete completed."
}

Registers AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Attribute

List register transactions AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

List register bulk action history AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Path Parameters

Query Parameters

Get register bulk update edit page AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Get register budget vs actuals AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Bulk update register transactions AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Arguments

Path Parameters

Query Parameters

Bulk delete register transactions AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Registers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List register transactions AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab