Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Inventory taxes API

Taxes Module

Zoho Inventory taxes API is one of 37 APIs that Zoho Inventory publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include taxes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

This API exposes 19 operations across 8 paths, and defines 68 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://www.zohoapis.com/inventory/v1.

19 operations 8 paths 68 schemas 4 DELETE7 GET4 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://www.zohoapis.com/inventory/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho Inventory taxes API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Zoho_Auth) using the implicit flow, exposing 4 scopes.

Paths & Operations 19

Across 8 paths, the API surfaces 19 operations — 4 DELETE, 7 GET, 4 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

taxes 19

Taxes Module

POST
/settings/taxes
Create a tax
create_tax 1 param body → 201
GET
/settings/taxes
List taxes
list_taxes 3 params → 200
PUT
/settings/taxes/{tax_id}
Update a tax
update_tax 2 params body → 200
GET
/settings/taxes/{tax_id}
Get a tax
get_tax 2 params → 200
DELETE
/settings/taxes/{tax_id}
Delete a tax
delete_tax 2 params → 200
GET
/settings/taxgroups/{tax_group_id}
Get a tax group
get_tax_group 2 params → 200
PUT
/settings/taxgroups/{tax_group_id}
Update a tax group
update_tax_group 2 params body → 200
DELETE
/settings/taxgroups/{tax_group_id}
Delete a tax group
delete_tax_group 2 params → 200
POST
/settings/taxgroups
Create a tax group
create_tax_group 1 param body → 201
POST
/settings/taxauthorities
Create a tax authority [US and CA Edition only]
create_tax_authority 1 param body → 201
GET
/settings/taxauthorities
List tax authorities [US Edition only]
list_tax_authorities 1 param → 200
PUT
/settings/taxauthorities/{tax_authority_id}
Update a tax authority [US and CA Edition only]
update_tax_authority 2 params body → 200
GET
/settings/taxauthorities/{tax_authority_id}
Get a tax authority [US and CA Edition only]
get_tax_authority 2 params → 200
DELETE
/settings/taxauthorities/{tax_authority_id}
Delete a tax authority [US and CA Edition only]
delete_tax_authority 2 params → 200
POST
/settings/taxexemptions
Create a tax exemption [US Edition only]
create_tax_exemption 1 param body → 200
GET
/settings/taxexemptions
List tax exemptions [US Edition only]
list_tax_exemptions 1 param → 200
PUT
/settings/taxexemptions/{tax_exemption_id}
Update a tax exemption [US Edition only]
update_tax_exemption 2 params body → 200
GET
/settings/taxexemptions/{tax_exemption_id}
Get a tax exemption [US Edition only]
get_tax_exemption 2 params → 200
DELETE
/settings/taxexemptions/{tax_exemption_id}
Delete a tax exemption [US Edition only]
delete_tax_exemption 2 params → 200

Schemas 68

The contract defines 68 schemas that model the data the API accepts and returns. The most detailed are update-a-tax-request (14 properties), create-a-tax-request (13 properties), tax-response (13 properties), tax_authority (5 properties). Each schema is shown below with its type and property counts.

country
string
Country to which the tax belongs.
update-a-tax-exemption-us-edition-only-response
object
3 properties
country_code
string
Two letter country code for the EU country to which the tax belongs.
list-taxes-response
object
4 properties
is_value_added
boolean
Check if Tax is Value Added
get-a-tax-exemption-us-edition-only-response
object
3 properties
create-a-tax-response
object
3 properties
registration_number
string
Registration Number of the Tax Authority
tax_id
string
Unique ID of the tax
delete-a-tax-exemption-us-edition-only-response
object
2 properties
tax_factor
string
Tax Factor
update-a-tax-request
object
14 properties
create-a-tax-exemption-us-edition-only-response
object
3 properties
tax-response
object
13 properties
purchase_tax_account_id
string
ID of the tax account, in case of withholding tax.
output_tax_account_name
string
taxes
string
Comma Seperated list of tax IDs that are to be associated to the tax group.
get-a-tax-response
object
3 properties
create-a-tax-exemption-us-edition-only-request
object
3 properties 2 required
is_editable
boolean
To check if tax/tax rate is editable
create-a-tax-authority-us-and-ca-edition-only-request
object
4 properties 1 required
update-a-tax-group-response
object
3 properties
tax_authority
object
5 properties
list-tax-authorities-us-edition-only-response
object
3 properties
page
integer
Number of pages
purchase_tax_account_name
string
create-a-tax-request
object
13 properties
update-a-tax-authority-us-and-ca-edition-only-response
object
3 properties
update-a-tax-exemption-us-edition-only-request
object
3 properties 2 required
update_draft_so
boolean
Check if Draft Sales Orders should be updated
tax_percentage
number
Number of percentage taxable.
applied_filter
string
The filer applied for sorting
tds_payable_account_id
string
Input Tax ID. The amount of money charged to you as Tax on your purchases.
get-a-tax-group-response
object
3 properties
tax_exemption_id
string
ID of the Tax Exemption
create-a-tax-group-response
object
3 properties
tax_specific_type
string
Type of Tax For Indian Edition. Allowed Values : igst , cgst , sgst , nil , cess . Type of Tax for Mexico Edition. Allowed Values : isr , iva , ieps .
list-tax-exemptions-us-edition-only-response
object
3 properties
has_more_page
boolean
Check if has more pages
update-a-tax-authority-us-and-ca-edition-only-request
object
4 properties
delete-a-tax-authority-us-and-ca-edition-only-response
object
2 properties
delete-a-tax-group-response
object
2 properties
report_name
string
The report name
per_page
integer
Per page values
is_default_tax
boolean
Check if Tax is default
sort_column
string
Sort taxes.Allowed Values: taxname , taxes , date , duedate , total , balance and createdtime
create-a-tax-authority-us-and-ca-edition-only-response
object
3 properties
update-a-tax-group-request
object
2 properties
tax_authority_name
string
Name of the TAX authority
tax_group_id
string
the id of the tax group
type
string
Type of the tax exemption, can be customer or item .
purchase_tax_expense_account_id
string
Account ID in which Purchase Tax will be Computed
create-a-tax-group-request
object
2 properties
tax_account_id
string
tax_type
string
Type to determine whether it is a simple or compound tax. Allowed Values: tax and compoundtax
update-a-tax-response
object
3 properties
tax_authority_id
string
ID of the tax authority. Tax authority depends on the location of the customer. For example, if the customer is located in NY, then the tax authority is NY tax…
registration_number_label
string
The registration number label of the tax authority
description
string
Description.
tax_group_percentage
number
Number of percentage taxable.
tax
array
sort_order
string
The order for sorting
get-a-tax-authority-us-and-ca-edition-only-response
object
3 properties
tax_group_name
string
Name of the tax group to be created.
tax_name
string
Name of the tax to be created.
tax_exemption_code
string
Code of the Tax Exemption
delete-a-tax-response
object
2 properties
update_draft_invoice
boolean
Check if Draft Invoices should be updated

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-inventory-taxes-api-openapi.yml Raw ↑

Other APIs Zoho Inventory publishes across the network.

Zoho Inventory batches API
Zoho Inventory bills API
Zoho Inventory compositeitems API
Zoho Inventory contact-persons API
Zoho Inventory contacts API
Zoho Inventory credit-notes API
Zoho Inventory currency API
Zoho Inventory customer-payments API
Zoho Inventory delivery-challans API
Zoho Inventory inventoryadjustments API
Zoho Inventory invoices API
Zoho Inventory itemgroups API