Journals 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

(Optional) VAT treatment for the journals. VAT treatment denotes the location of the customer, if the customer resides in UK then the VAT treatment is uk. If the customer is in an EU country & VAT registered, you are resides in Northen Ireland and selling Goods then his VAT treatment is eu_vat_registered, if he resides outside of the UK then his VAT treatment is overseas (For Pre Brexit, this can be split as eu_vat_registered, eu_vat_not_registered and non_eu).

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

line_items

array

Line items for the journal.

Show Sub-Attributes

line_id

string

ID of the Line

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

customer_name

string

Name of the Customer/Vendor

account_name

string

Name of the Account

description

string

Description that can be given at the line item level.

debit_or_credit

string

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

tax_name

string

Name of the Tax

tax_type

string

Type of the Tax

tax_percentage

string

Percentage of the Tax

amount

double

Amount to be recorded for the journal.

bcy_amount

double

Amount in Base Currency

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

acquisition_vat_name

string

🇬🇧 , Europe only

Name of the VAT Acquistion

acquisition_vat_percentage

string

🇬🇧 , Europe only

Percentage of the VAT Acquistion

acquisition_vat_amount

string

🇬🇧 , Europe only

Amount of the VAT Acquistion

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

reverse_charge_vat_name

string

🇬🇧 , Europe only

Name of the Reverse Charge

reverse_charge_vat_percentage

string

🇬🇧 , Europe only

Percentage of the Reverse Charge

reverse_charge_vat_amount

string

🇬🇧 , Europe only

Percentage of the Reverse Charge

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

location_id

string

Location ID

location_name

string

Name of the location.

project_id

string

ID of the Project

project_name

string

Name of the Project

location_id

string

Location ID

location_name

string

Name of the location.

line_item_total

double

Total of the Line Item

total

double

Total of the Journal

bcy_total

double

Total in Base Currency

price_precision

integer

Price Precision for the Values

taxes

array

Show Sub-Attributes

tax_name

string

Name of the Tax

tax_amount

double

Amount of Tax

debit_or_credit

string

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

tax_account

boolean

Account for recording Tax

created_time

string

Created Time of the Journal

last_modified_time

string

Last Modified Time of the Journal

status

string

Search Journal by journal status. Allowed Values: draft and published.

custom_fields

array

Custom fields for the journal.

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_name

string

Tag's Name

tag_option_id

string

Tag Option's ID

tag_option_name

string

Tag Option's Name

is_tag_mandatory

boolean

Used to check if the tag is mandatory

{
    "journal_id": "460000000038001",
    "entry_number": "1",
    "reference_number": "7355",
    "notes": "Loan repayment",
    "currency_id": "460000000000097",
    "currency_code": "USD",
    "currency_symbol": "$",
    "exchange_rate": 1,
    "journal_date": "2013-09-04",
    "journal_type": "both",
    "vat_treatment": "string",
    "product_type": "string",
    "include_in_vat_return": true,
    "is_bas_adjustment": true,
    "line_items": [
        {
            "line_id": "460000000038005",
            "account_id": "460000000000361",
            "customer_id": "string",
            "customer_name": "string",
            "account_name": "Petty Cash",
            "description": "string",
            "debit_or_credit": "credit",
            "tax_exemption_id": "string",
            "tax_exemption_type": "string",
            "tax_exemption_code": "string",
            "tax_authority_id": "string",
            "tax_authority_name": "string",
            "tax_id": "string",
            "tax_name": "string",
            "tax_type": "tax",
            "tax_percentage": "string",
            "amount": 5000,
            "bcy_amount": 100,
            "acquisition_vat_id": "string",
            "acquisition_vat_name": "string",
            "acquisition_vat_percentage": "string",
            "acquisition_vat_amount": "string",
            "reverse_charge_vat_id": "string",
            "reverse_charge_vat_name": "string",
            "reverse_charge_vat_percentage": "string",
            "reverse_charge_vat_amount": "string",
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_option_id": "460000000014044"
                }
            ],
            "location_id": "460000000038080",
            "location_name": "string",
            "project_id": "460000000898001",
            "project_name": "Network Distribution"
        }
    ],
    "location_id": "460000000038080",
    "location_name": "string",
    "line_item_total": 5000,
    "total": 5000,
    "bcy_total": 100,
    "price_precision": 2,
    "taxes": [
        {
            "tax_name": "string",
            "tax_amount": 0,
            "debit_or_credit": "credit",
            "tax_account": true
        }
    ],
    "created_time": "2013-09-04T09:40:07+0530",
    "last_modified_time": "2013-09-05T17:13:31+0530",
    "status": "draft",
    "custom_fields": [
        {
            "customfield_id": "460000000098001",
            "value": "Normal"
        }
    ],
    "tags": [
        {
            "tag_id": "460000000000567",
            "tag_name": "Business Unit",
            "tag_option_id": "460000000014044",
            "tag_option_name": "Sales",
            "is_tag_mandatory": false
        }
    ]
}

Create a journal 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

Create a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

journal_date

string

(Required)

Date on which the journal to be recorded.

reference_number

string

Reference number for the journal.

notes

string

Notes for the journal.

journal_type

string

Type of the Journal. Allowed values: Cash and Both .

vat_treatment

string

🇬🇧 , Europe only

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

currency_id

string

ID of the Currency Associated with the Journal

exchange_rate

double

Exchange Rate between the Currencies

location_id

string

Location ID

line_items

array

Line items for the journal.

Show Sub-Attributes

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

line_id

string

ID of the Line

description

string

Description that can be given at the line item level.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

amount

double

(Required)

Amount to be recorded for the journal.

debit_or_credit

string

(Required)

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

location_id

string

Location ID

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

project_id

string

ID of the Project

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

status

string

Search Journal by journal status. Allowed Values: draft and published.

custom_fields

array

Custom fields for the journal.

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

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

{
    "journal_date": "2013-09-04",
    "reference_number": "7355",
    "notes": "Loan repayment",
    "journal_type": "both",
    "vat_treatment": "string",
    "include_in_vat_return": true,
    "product_type": "string",
    "is_bas_adjustment": true,
    "currency_id": "460000000000097",
    "exchange_rate": 1,
    "location_id": "460000000038080",
    "line_items": [
        {
            "account_id": "460000000000361",
            "customer_id": "string",
            "line_id": "460000000038005",
            "description": "string",
            "tax_exemption_id": "string",
            "tax_authority_id": "string",
            "tax_exemption_type": "string",
            "tax_exemption_code": "string",
            "tax_authority_name": "string",
            "tax_id": "string",
            "amount": 5000,
            "debit_or_credit": "credit",
            "acquisition_vat_id": "string",
            "reverse_charge_vat_id": "string",
            "location_id": "460000000038080",
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_option_id": "460000000014044"
                }
            ],
            "project_id": "460000000898001"
        }
    ],
    "tax_exemption_code": "string",
    "tax_exemption_type": "string",
    "status": "draft",
    "custom_fields": [
        {
            "customfield_id": "460000000098001",
            "value": "Normal"
        }
    ],
    "tags": [
        {
            "tag_id": "460000000000567",
            "tag_option_id": "460000000014044"
        }
    ]
}

{
    "code": 0,
    "message": "The journal entry has been created.",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

Get journal list 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

Get journal list.
OAuth Scope : ZohoBooks.accountants.READ

Query Parameters

organization_id

string

(Required)

ID of the organization

entry_number

string

Search journals by journal entry number. Variants: entry_number_startswith and entry_number_contains

reference_number

string

Search journals by journal reference number. Variants: reference_number_startswith and reference_number_contains

date

string

Search journals by journal date. Variants: date_start, date_end, date_before and date_after

notes

string

Search journals by journal notes. Variants: notes_startswith and notes_contains

last_modified_time

string

Search the journals using Last Modified Time

total

double

Search journals by journal total. Variants: total_less_than, total_less_equals, total_greater_than and total_greater_equals

customer_id

string

Search Journals using Customer ID

vendor_id

string

Search the journals using Vendor ID

filter_by

string

Filter journals by journal date. Allowed Values: JournalDate.All, JournalDate.Today, JournalDate.ThisWeek, JournalDate.ThisMonth, JournalDate.ThisQuarter and JournalDate.ThisYear

sort_column

string

Sort journal list. Allowed Values: journal_date, entry_number, reference_number, total and last_modified_time.

status

string

Filter journals by status. Allowed Values: draft, published, approved, submitted and rejected.

journal_type

string

Filter journals by journal type.

account_id

string

Filter journals by account ID.

account_code

string

Search journals by account code.

customview_id

string

ID of the custom view.

journal_ids

string

Comma separated journal IDs. Maximum of 200.

currency

string

Filter by currency ID.

tax_id

string

Filter by tax ID.

tax_exemption_id

string

Filter by tax exemption ID.

tax_authority_id

string

Filter by tax authority ID.

search_text

string

Search journals by text.

branch_ids

string

Comma separated branch IDs. Maximum of 200.

location_ids

string

Comma separated location IDs. Maximum of 200.

project_id

string

Filter by project ID.

journal_entity_type

string

Filter by journal entity type. Allowed Values: journal, period_end_journal, consolidation_journal, consolidation_adjustment_journal, elimination_journal and intercompany_journal.

period_closure_id

string

Filter by period closure ID.

page

integer

Page number to be fetched. Default value is 1.

per_page

integer

Number of records to be fetched per page.

Request Example

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

{
    "code": 0,
    "message": "success",
    "journals": [
        {
            "journal_id": "460000000038001",
            "journal_date": "2013-09-04",
            "entry_number": "1",
            "reference_number": "7355",
            "currency_id": "460000000000097",
            "notes": "Loan repayment",
            "journal_type": "both",
            "entity_type": "journal",
            "total": 5000,
            "bcy_total": 100,
            "custom_field": "string",
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_name": "Business Unit",
                    "tag_option_id": "460000000014044",
                    "tag_option_name": "Sales",
                    "is_tag_mandatory": false
                }
            ]
        },
        {...},
        {...}
    ]
}

Update a journal 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

Updates the journal with given information.
OAuth Scope : ZohoBooks.accountants.UPDATE

Arguments

journal_date

string

(Required)

Date on which the journal to be recorded.

reference_number

string

Reference number for the journal.

notes

string

Notes for the journal.

journal_type

string

Type of the Journal. Allowed values: Cash and Both .

vat_treatment

string

🇬🇧 , Europe only

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

currency_id

string

ID of the Currency Associated with the Journal

exchange_rate

double

Exchange Rate between the Currencies

location_id

string

Location ID

line_items

array

Line items for the journal.

Show Sub-Attributes

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

line_id

string

ID of the Line

description

string

Description that can be given at the line item level.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

amount

double

(Required)

Amount to be recorded for the journal.

debit_or_credit

string

(Required)

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

location_id

string

Location ID

project_id

string

ID of the Project

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

custom_fields

array

Custom fields for the journal.

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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

{
    "journal_date": "2013-09-04",
    "reference_number": "7355",
    "notes": "Loan repayment",
    "journal_type": "both",
    "vat_treatment": "string",
    "include_in_vat_return": true,
    "product_type": "string",
    "is_bas_adjustment": true,
    "currency_id": "460000000000097",
    "exchange_rate": 1,
    "location_id": "460000000038080",
    "line_items": [
        {
            "account_id": "460000000000361",
            "customer_id": "string",
            "line_id": "460000000038005",
            "description": "string",
            "tax_exemption_id": "string",
            "tax_authority_id": "string",
            "tax_exemption_type": "string",
            "tax_exemption_code": "string",
            "tax_authority_name": "string",
            "tax_id": "string",
            "amount": 5000,
            "debit_or_credit": "credit",
            "acquisition_vat_id": "string",
            "reverse_charge_vat_id": "string",
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_option_id": "460000000014044"
                }
            ],
            "location_id": "460000000038080",
            "project_id": "460000000898001"
        }
    ],
    "tax_exemption_code": "string",
    "tax_exemption_type": "string",
    "custom_fields": [
        {
            "customfield_id": "460000000098001",
            "value": "Normal"
        }
    ],
    "tags": [
        {
            "tag_id": "460000000000567",
            "tag_option_id": "460000000014044"
        }
    ]
}

{
    "code": 0,
    "message": "The journal entry has been updated.",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

Get journal 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

Get the details of the journal.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

Delete a journal 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

Deletes the given journal.
OAuth Scope : ZohoBooks.accountants.DELETE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?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/journals/460000000038001?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The selected journal entry has been deleted."
}

Mark a journal as published 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

Mark a draft journal as published.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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/journals/460000000038001/status/publish?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/journals/460000000038001/status/publish?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/journals/460000000038001/status/publish?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/journals/460000000038001/status/publish?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/journals/460000000038001/status/publish?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/journals/460000000038001/status/publish?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "Journal has been published."
}

Add attachment to a journal 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

Attach a file to a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

Query Parameters

organization_id

string

(Required)

ID of the organization

attachment

binary

The file that is to be added as an Attachment in the Journal

doc

binary

Document that is to be attached

totalFiles

integer

Total number of files.

document_ids

string

ID's of the document

Request Example

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

{
    "code": 0,
    "message": "Your file has been successfully attached to the journal."
}

Add comment 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

Add a comment for a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

description

string

Description of a comment

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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

{
    "description": "Journal Created"
}

{
    "code": 0,
    "message": "Journal comment has been added successfully.",
    "comment": [
        {
            "comment_id": "460000000048023",
            "description": "string",
            "commented_by_id": "460000000017003",
            "commented_by": "John",
            "comment_type": "system",
            "date": "string",
            "operation_type": "Added"
        },
        {...},
        {...}
    ]
}

Delete a comment 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

Delete a jounral comment.
OAuth Scope : ZohoBooks.accountants.DELETE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

comment_id

string

(Required)

Unique identifier of the comment.

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/journals/460000000038001/comments/460000000048023?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/journals/460000000038001/comments/460000000048023?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/journals/460000000038001/comments/460000000048023?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/journals/460000000038001/comments/460000000048023?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/journals/460000000038001/comments/460000000048023?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/journals/460000000038001/comments/460000000048023?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The selected journal comment entries have been deleted."
}

Reverse a journal 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

Reverses a journal entry.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

Query Parameters

organization_id

string

(Required)

ID of the organization

reversal_date

string

(Required)

Date on which the reversal needs to be recorded.

is_reversal_scheduled

boolean

(Required)

Whether the reversal is scheduled.

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/journals/460000000038001/reverse?organization_id=10234695&reversal_date=2013-10-01&is_reversal_scheduled=false"
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/journals/460000000038001/reverse?organization_id=10234695&reversal_date=2013-10-01&is_reversal_scheduled=false")
  .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/journals/460000000038001/reverse?organization_id=10234695&reversal_date=2013-10-01&is_reversal_scheduled=false', 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/journals/460000000038001/reverse?organization_id=10234695&reversal_date=2013-10-01&is_reversal_scheduled=false", 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/journals/460000000038001/reverse?organization_id=10234695&reversal_date=2013-10-01&is_reversal_scheduled=false",
  "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/journals/460000000038001/reverse?organization_id=10234695&reversal_date=2013-10-01&is_reversal_scheduled=false' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The journal entry has been reversed.",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

Submit a journal for approval 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

Submits a journal for approval.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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/journals/460000000038001/submit?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/journals/460000000038001/submit?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/journals/460000000038001/submit?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/journals/460000000038001/submit?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/journals/460000000038001/submit?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/journals/460000000038001/submit?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success"
}

Approve a journal 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

Approves a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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/journals/460000000038001/approve?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/journals/460000000038001/approve?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/journals/460000000038001/approve?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/journals/460000000038001/approve?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/journals/460000000038001/approve?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/journals/460000000038001/approve?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success"
}

Reject a journal 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

Rejects a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

Query Parameters

organization_id

string

(Required)

ID of the organization

reason

string

Reason for rejecting the journal. Max-length [500].

Request Example

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

{
    "code": 0,
    "message": "success"
}

List available credits of a journal 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

Lists available credits of a journal.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

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/journals/460000000038001/credits?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/journals/460000000038001/credits?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/journals/460000000038001/credits?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/journals/460000000038001/credits?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/journals/460000000038001/credits?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/journals/460000000038001/credits?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "credits": [
        {
            "credit_id": "string",
            "amount": 5000,
            "balance": 0
        },
        {...},
        {...}
    ]
}

Apply journal credits to invoices 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

Applies available journal credits to invoices.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

invoices

array

List of invoices to which the journal credits are applied.

Show Sub-Attributes

invoice_id

string

ID of the invoice.

amount_applied

double

Amount to be applied.

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

journal_line_id

string

(Required)

Unique identifier of the journal line item.

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

{
    "invoices": [
        {
            "invoice_id": "string",
            "amount_applied": 0
        }
    ]
}

{
    "code": 0,
    "message": "success"
}

Apply journal credits to bills 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

Applies available journal credits to bills.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

invoices

array

List of invoices to which the journal credits are applied.

Show Sub-Attributes

invoice_id

string

ID of the invoice.

amount_applied

double

Amount to be applied.

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

journal_line_id

string

(Required)

Unique identifier of the journal line item.

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

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

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/journals/460000000038001/credits/460000000038005/bills?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/journals/460000000038001/credits/460000000038005/bills?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/journals/460000000038001/credits/460000000038005/bills?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    "content-type": "application/json"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();

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

{
    "invoices": [
        {
            "invoice_id": "string",
            "amount_applied": 0
        }
    ]
}

{
    "code": 0,
    "message": "success"
}

Delete applied credits from receivables 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

Deletes applied journal credits from receivables.
OAuth Scope : ZohoBooks.accountants.DELETE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

journal_line_id

string

(Required)

Unique identifier of the journal line item.

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/journals/460000000038001/credits/460000000038005/receivables?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/journals/460000000038001/credits/460000000038005/receivables?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/journals/460000000038001/credits/460000000038005/receivables?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/journals/460000000038001/credits/460000000038005/receivables?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/journals/460000000038001/credits/460000000038005/receivables?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/journals/460000000038001/credits/460000000038005/receivables?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success"
}

Delete applied credits from payables 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

Deletes applied journal credits from payables.
OAuth Scope : ZohoBooks.accountants.DELETE

Path Parameters

journal_id

string

(Required)

Unique identifier of the journal.

journal_line_id

string

(Required)

Unique identifier of the journal line item.

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/journals/460000000038001/credits/460000000038005/payables?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/journals/460000000038001/credits/460000000038005/payables?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/journals/460000000038001/credits/460000000038005/payables?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/journals/460000000038001/credits/460000000038005/payables?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/journals/460000000038001/credits/460000000038005/payables?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/journals/460000000038001/credits/460000000038005/payables?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success"
}

Bulk submit journals for approval 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

Submits multiple journals for approval.
OAuth Scope : ZohoBooks.accountants.CREATE

Query Parameters

organization_id

string

(Required)

ID of the organization

journal_ids

string

(Required)

Comma separated journal IDs to be submitted. Maximum of 25.

Request Example

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

{
    "code": 0,
    "message": "success"
}

Bulk approve journals 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

Approves multiple journals.
OAuth Scope : ZohoBooks.accountants.CREATE

Query Parameters

organization_id

string

(Required)

ID of the organization

journal_ids

string

(Required)

Comma separated journal IDs to be approved. Maximum of 25.

Request Example

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

{
    "code": 0,
    "message": "success"
}

Bulk publish journals 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

Publishes multiple draft journals.
OAuth Scope : ZohoBooks.accountants.CREATE

Query Parameters

organization_id

string

(Required)

ID of the organization

journal_ids

string

(Required)

Comma separated journal IDs to be published. Maximum of 10.

Request Example

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

{
    "code": 0,
    "message": "success"
}

Bulk delete journals 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

Deletes multiple journals.
OAuth Scope : ZohoBooks.accountants.DELETE

Query Parameters

organization_id

string

(Required)

ID of the organization

journal_ids

string

(Required)

Comma separated journal IDs to be deleted. Maximum of 200.

Request Example

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

{
    "code": 0,
    "message": "The selected journal entry has been deleted."
}

Create a recurring journal 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

Creates a recurring journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

journal_date

string

(Required)

Date on which the journal to be recorded.

reference_number

string

Reference number for the journal.

notes

string

Notes for the journal.

journal_type

string

Type of the Journal. Allowed values: Cash and Both .

vat_treatment

string

🇬🇧 , Europe only

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

currency_id

string

ID of the Currency Associated with the Journal

exchange_rate

double

Exchange Rate between the Currencies

location_id

string

Location ID

line_items

array

Line items for the journal.

Show Sub-Attributes

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

line_id

string

ID of the Line

description

string

Description that can be given at the line item level.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

amount

double

(Required)

Amount to be recorded for the journal.

debit_or_credit

string

(Required)

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

location_id

string

Location ID

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

project_id

string

ID of the Project

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

status

string

Search Journal by journal status. Allowed Values: draft and published.

custom_fields

array

Custom fields for the journal.

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

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

{
    "journal_date": "2013-09-04",
    "reference_number": "7355",
    "notes": "Loan repayment",
    "journal_type": "both",
    "vat_treatment": "string",
    "include_in_vat_return": true,
    "product_type": "string",
    "is_bas_adjustment": true,
    "currency_id": "460000000000097",
    "exchange_rate": 1,
    "location_id": "460000000038080",
    "line_items": [
        {
            "account_id": "460000000000361",
            "customer_id": "string",
            "line_id": "460000000038005",
            "description": "string",
            "tax_exemption_id": "string",
            "tax_authority_id": "string",
            "tax_exemption_type": "string",
            "tax_exemption_code": "string",
            "tax_authority_name": "string",
            "tax_id": "string",
            "amount": 5000,
            "debit_or_credit": "credit",
            "acquisition_vat_id": "string",
            "reverse_charge_vat_id": "string",
            "location_id": "460000000038080",
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_option_id": "460000000014044"
                }
            ],
            "project_id": "460000000898001"
        }
    ],
    "tax_exemption_code": "string",
    "tax_exemption_type": "string",
    "status": "draft",
    "custom_fields": [
        {
            "customfield_id": "460000000098001",
            "value": "Normal"
        }
    ],
    "tags": [
        {
            "tag_id": "460000000000567",
            "tag_option_id": "460000000014044"
        }
    ]
}

{
    "code": 0,
    "message": "The journal entry has been created.",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

List recurring journals 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

Lists all recurring journals.
OAuth Scope : ZohoBooks.accountants.READ

Query Parameters

organization_id

string

(Required)

ID of the organization

filter_by

string

Filter recurring journals by status. Allowed Values: Status.All, Status.Active, Status.Stopped and Status.Expired.

sort_column

string

Sort recurring journals. Allowed Values: created_time, total and bcy_total.

account_id

string

Filter by account ID.

Request Example

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

{
    "code": 0,
    "message": "success",
    "recurring_journals": [
        {
            "journal_id": "460000000038001",
            "entry_number": "1",
            "reference_number": "7355",
            "notes": "Loan repayment",
            "currency_id": "460000000000097",
            "currency_code": "USD",
            "currency_symbol": "$",
            "exchange_rate": 1,
            "journal_date": "2013-09-04",
            "journal_type": "both",
            "vat_treatment": "string",
            "product_type": "string",
            "include_in_vat_return": true,
            "is_bas_adjustment": true,
            "line_items": [
                {
                    "line_id": "460000000038005",
                    "account_id": "460000000000361",
                    "customer_id": "string",
                    "customer_name": "string",
                    "account_name": "Petty Cash",
                    "description": "string",
                    "debit_or_credit": "credit",
                    "tax_exemption_id": "string",
                    "tax_exemption_type": "string",
                    "tax_exemption_code": "string",
                    "tax_authority_id": "string",
                    "tax_authority_name": "string",
                    "tax_id": "string",
                    "tax_name": "string",
                    "tax_type": "tax",
                    "tax_percentage": "string",
                    "amount": 5000,
                    "bcy_amount": 100,
                    "acquisition_vat_id": "string",
                    "acquisition_vat_name": "string",
                    "acquisition_vat_percentage": "string",
                    "acquisition_vat_amount": "string",
                    "reverse_charge_vat_id": "string",
                    "reverse_charge_vat_name": "string",
                    "reverse_charge_vat_percentage": "string",
                    "reverse_charge_vat_amount": "string",
                    "tags": [
                        {
                            "tag_id": "460000000000567",
                            "tag_option_id": "460000000014044"
                        }
                    ],
                    "location_id": "460000000038080",
                    "location_name": "string",
                    "project_id": "460000000898001",
                    "project_name": "Network Distribution"
                }
            ],
            "location_id": "460000000038080",
            "location_name": "string",
            "line_item_total": 5000,
            "total": 5000,
            "bcy_total": 100,
            "price_precision": 2,
            "taxes": [
                {
                    "tax_name": "string",
                    "tax_amount": 0,
                    "debit_or_credit": "credit",
                    "tax_account": true
                }
            ],
            "created_time": "2013-09-04T09:40:07+0530",
            "last_modified_time": "2013-09-05T17:13:31+0530",
            "status": "draft",
            "custom_fields": [
                {
                    "customfield_id": "460000000098001",
                    "value": "Normal"
                }
            ],
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_name": "Business Unit",
                    "tag_option_id": "460000000014044",
                    "tag_option_name": "Sales",
                    "is_tag_mandatory": false
                }
            ]
        },
        {...},
        {...}
    ],
    "page_context": {
        "page": 1,
        "per_page": 10,
        "has_more_page": false,
        "report_name": "Manual Journals",
        "applied_filter": "JournalDate.All",
        "sort_column": "journal_date",
        "sort_order": "D"
    }
}

Update a recurring journal 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

Updates an existing recurring journal.
OAuth Scope : ZohoBooks.accountants.UPDATE

Arguments

journal_date

string

(Required)

Date on which the journal to be recorded.

reference_number

string

Reference number for the journal.

notes

string

Notes for the journal.

journal_type

string

Type of the Journal. Allowed values: Cash and Both .

vat_treatment

string

🇬🇧 , Europe only

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

currency_id

string

ID of the Currency Associated with the Journal

exchange_rate

double

Exchange Rate between the Currencies

location_id

string

Location ID

line_items

array

Line items for the journal.

Show Sub-Attributes

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

line_id

string

ID of the Line

description

string

Description that can be given at the line item level.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

amount

double

(Required)

Amount to be recorded for the journal.

debit_or_credit

string

(Required)

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

location_id

string

Location ID

project_id

string

ID of the Project

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

custom_fields

array

Custom fields for the journal.

Show Sub-Attributes

customfield_id

string

ID of the Custom Field

value

string

Value of the Custom Field

tags

array

Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.

Show Sub-Attributes

tag_id

string

Tag's ID

tag_option_id

string

Tag Option's ID

Path Parameters

recurring_journal_id

string

(Required)

Unique identifier of the recurring journal.

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

{
    "journal_date": "2013-09-04",
    "reference_number": "7355",
    "notes": "Loan repayment",
    "journal_type": "both",
    "vat_treatment": "string",
    "include_in_vat_return": true,
    "product_type": "string",
    "is_bas_adjustment": true,
    "currency_id": "460000000000097",
    "exchange_rate": 1,
    "location_id": "460000000038080",
    "line_items": [
        {
            "account_id": "460000000000361",
            "customer_id": "string",
            "line_id": "460000000038005",
            "description": "string",
            "tax_exemption_id": "string",
            "tax_authority_id": "string",
            "tax_exemption_type": "string",
            "tax_exemption_code": "string",
            "tax_authority_name": "string",
            "tax_id": "string",
            "amount": 5000,
            "debit_or_credit": "credit",
            "acquisition_vat_id": "string",
            "reverse_charge_vat_id": "string",
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_option_id": "460000000014044"
                }
            ],
            "location_id": "460000000038080",
            "project_id": "460000000898001"
        }
    ],
    "tax_exemption_code": "string",
    "tax_exemption_type": "string",
    "custom_fields": [
        {
            "customfield_id": "460000000098001",
            "value": "Normal"
        }
    ],
    "tags": [
        {
            "tag_id": "460000000000567",
            "tag_option_id": "460000000014044"
        }
    ]
}

{
    "code": 0,
    "message": "The journal entry has been updated.",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

Get a recurring journal 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

Gets the details of a recurring journal.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

recurring_journal_id

string

(Required)

Unique identifier of the recurring journal.

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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

Delete a recurring journal 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

Deletes a recurring journal.
OAuth Scope : ZohoBooks.accountants.DELETE

Path Parameters

recurring_journal_id

string

(Required)

Unique identifier of the recurring journal.

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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?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/recurringjournals/460000000042001?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The selected journal entry has been deleted."
}

Resume a recurring journal 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

Resumes a stopped recurring journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

recurring_journal_id

string

(Required)

Unique identifier of the recurring journal.

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/recurringjournals/460000000042001/status/resume?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/recurringjournals/460000000042001/status/resume?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/recurringjournals/460000000042001/status/resume?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/recurringjournals/460000000042001/status/resume?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/recurringjournals/460000000042001/status/resume?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/recurringjournals/460000000042001/status/resume?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success"
}

Stop a recurring journal 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

Stops an active recurring journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Path Parameters

recurring_journal_id

string

(Required)

Unique identifier of the recurring journal.

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/recurringjournals/460000000042001/status/stop?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/recurringjournals/460000000042001/status/stop?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/recurringjournals/460000000042001/status/stop?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/recurringjournals/460000000042001/status/stop?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/recurringjournals/460000000042001/status/stop?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/recurringjournals/460000000042001/status/stop?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success"
}

List child journals of a recurring journal 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

Lists all child journals created from a recurring journal.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

recurring_journal_id

string

(Required)

Unique identifier of the recurring journal.

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/recurringjournals/460000000042001/journals?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/recurringjournals/460000000042001/journals?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/recurringjournals/460000000042001/journals?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/recurringjournals/460000000042001/journals?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/recurringjournals/460000000042001/journals?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/recurringjournals/460000000042001/journals?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "journals": [
        {
            "journal_id": "460000000038001",
            "journal_date": "2013-09-04",
            "entry_number": "1",
            "reference_number": "7355",
            "currency_id": "460000000000097",
            "notes": "Loan repayment",
            "journal_type": "both",
            "entity_type": "journal",
            "total": 5000,
            "bcy_total": 100,
            "custom_field": "string",
            "tags": [
                {
                    "tag_id": "460000000000567",
                    "tag_name": "Business Unit",
                    "tag_option_id": "460000000014044",
                    "tag_option_name": "Sales",
                    "is_tag_mandatory": false
                }
            ]
        },
        {...},
        {...}
    ]
}

Get journal view of a transaction 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

Gets the journal view of a transaction.
OAuth Scope : ZohoBooks.accountants.READ

Path Parameters

transaction_id

string

(Required)

Unique identifier of the transaction.

Query Parameters

organization_id

string

(Required)

ID of the organization

entity_type

string

(Required)

Type of the transaction entity. Allowed Values: journal, invoice, creditnote, expense, bill, vendor_credit, customer_payment, vendor_payment and more.

report_basis

string

Basis for the report. Allowed Values: cash and accrual.

Request Example

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

{
    "code": 0,
    "message": "success",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "tag_id": "460000000000567",
                        "tag_option_id": "460000000014044"
                    }
                ],
                "location_id": "460000000038080",
                "location_name": "string",
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "location_id": "460000000038080",
        "location_name": "string",
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ],
        "tags": [
            {
                "tag_id": "460000000000567",
                "tag_name": "Business Unit",
                "tag_option_id": "460000000014044",
                "tag_option_name": "Sales",
                "is_tag_mandatory": false
            }
        ]
    }
}

Journals 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

Create a journal 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

Query Parameters

Get journal list 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

Query Parameters

Update a journal 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

Get journal 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

Delete a journal 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

Mark a journal as published 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

Add attachment to a journal 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

Add comment 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

Delete a comment 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

Reverse a journal 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

Submit a journal for approval 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

Approve a journal 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

Reject a journal 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 available credits of a journal 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

Apply journal credits to invoices 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

Apply journal credits to bills 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

Path Parameters

Query Parameters

Path Parameters

Query Parameters

Bulk submit journals for approval 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

Query Parameters

Bulk approve journals 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

Query Parameters

Bulk publish journals 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

Query Parameters

Bulk delete journals 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

Query Parameters

Create a recurring journal 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

Query Parameters

List recurring journals 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

Query Parameters

Update a recurring journal 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

Get a recurring journal 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

Delete a recurring journal 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

Journals 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

Create a journal 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

Get journal list 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

Update a journal 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

Get journal 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

Delete a journal 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

Mark a journal as published 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

Add attachment to a journal 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

Add comment 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

Delete a comment 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

Reverse a journal 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

Approve a journal 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

Reject a journal 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 approve journals 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 publish journals 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 journals 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

Create a recurring journal 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 recurring journals 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

Update a recurring journal 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

Get a recurring journal 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

Delete a recurring journal 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

Resume a recurring journal 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

Stop a recurring journal 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