How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Inventory items API

Items Module

Zoho Inventory items 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 Item. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

This API exposes 39 operations across 30 paths, and defines 115 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

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

39 operations 30 paths 115 schemas 5 DELETE12 GET14 POST8 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.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 items API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Zoho_Auth) using the implicit flow, exposing 4 scopes.

Paths & Operations 39

Across 30 paths, the API surfaces 39 operations — 5 DELETE, 12 GET, 14 POST, 8 PUT. Each is listed below with its method, path, parameters, and response codes.

items 39

Items Module

POST
/items
Create an item
create_item 1 param body → 200
GET
/items
List all the items
list_items 38 params → 200
DELETE
/items
Delete multiple items
bulk_delete_items 2 params → 200
GET
/itemdetails
Bulk fetch item details
list_item_details 2 params → 200
GET
/items/{item_id}
Retrieve an item
get_item 2 params → 200
PUT
/items/{item_id}
Update an item
update_item 2 params body → 200
DELETE
/items/{item_id}
Delete an item
delete_item 2 params → 200
PUT
/item/{item_id}/customfields
Update custom field in existing items
update_custom_field_in_item 2 params body → 200
POST
/items/{item_id}/image
Upload an item image
upload_item_image 2 params body → 200
GET
/items/{item_id}/image
Retrieve an item image
get_item_image 3 params → 200
DELETE
/items/{item_id}/image
Delete an item image
delete_item_image 2 params → 200
POST
/items/{item_id}/active
Mark as active
mark_item_as_active 2 params → 200
POST
/items/{item_id}/inactive
Mark as inactive
mark_item_as_inactive 2 params → 200
GET
/variants/{variant_id}/openingstock
Retrieve variant opening stock
get_variant_opening_stock 2 params → 200
PUT
/variants/{variant_id}/openingstock
Update variant opening stock
update_variant_opening_stock 2 params body → 200
POST
/items/{item_id}/images
Upload multiple item images
upload_item_images 5 params body → 200
DELETE
/items/{item_id}/images
Delete multiple item images
delete_item_images 3 params → 200
POST
/items/{item_id}/images/reorder
Reorder item images
reorder_item_images 2 params body → 200
POST
/items/{item_id}/backimage
Upload an item back image
upload_item_back_image 3 params body → 200
DELETE
/items/{item_id}/backimage
Delete an item back image
delete_item_back_image 3 params → 200
PUT
/items/{item_id}/images/{image_id}/backimage
Mark an image as back image
mark_image_as_back_image 3 params → 200
POST
/items/active
Bulk mark items as active
bulk_mark_items_active 2 params → 200
POST
/items/inactive
Bulk mark items as inactive
bulk_mark_items_inactive 2 params → 200
POST
/items/ungroup
Ungroup items
ungroup_items 3 params → 200
POST
/items/enablestoragelocation
Enable storage location for items
enable_storage_location 2 params → 200
POST
/items/disablestoragelocation
Disable storage location for items
disable_storage_location 2 params → 200
PUT
/items/move/{item_id}
Move an item
move_item 2 params body → 200
PUT
/items/grouping/{group_id}
Group items
group_items 2 params body → 200
PUT
/items/{item_id}/locations/permissions
Update item location permissions
update_item_location_permissions 4 params → 200
PUT
/items/locations/permissions
Bulk update item location permissions
bulk_update_item_location_permissions 4 params → 200
POST
/items/{item_id}/serialnumber/validate
Validate serial numbers
validate_serial_numbers 7 params → 200
POST
/items/{item_id}/serialnumber/validateandmap
Validate and map serial numbers
validate_and_map_serial_numbers 2 params body → 200
GET
/items/transactions/salesorders
List sales orders for an item
list_item_sales_orders 6 params → 200
GET
/items/transactions/purchaseorders
List purchase orders for an item
list_item_purchase_orders 5 params → 200
GET
/items/transactions/invoices
List invoices for an item
list_item_invoices 5 params → 200
GET
/items/transactions/deliverychallans
List delivery challans for an item
list_item_delivery_challans 5 params → 200
GET
/items/transactions/salesreceipts
List sales receipts for an item
list_item_sales_receipts 4 params → 200
GET
/items/transactions/moveorders
List move orders for an item
list_item_move_orders 3 params → 200
GET
/items/transactions/putaways
List putaways for an item
list_item_putaways 3 params → 200

Schemas 115

The contract defines 115 schemas that model the data the API accepts and returns. The most detailed are item-response (53 properties), update-an-item-request (50 properties), create-an-item-request (38 properties), group-items-request (7 properties). Each schema is shown below with its type and property counts.

group_id
string
Unique ID generated by the server for the group to which the item belongs, if any. This is used as an identifier.
move-item-response
object
2 properties
pricebook_rate
number
Pricelist rate applied on the item.
upc
integer
The 12 digit Unique Product Code (UPC) of the item.
update-item-location-permissions-response
object
2 properties
attribute_option_id1
string
Unique ID generated by the server for the attribute's options. This is used as an identifier.
location_stock_on_hand
string
Current available stock in your location.
disable-storage-location-response
object
2 properties
tax_type
string
Type of the Tax.
location_id
string
Location ID
delete-an-item-response
object
2 properties
attribute_option_name1
string
Name of the attribute's option.
track_inventory
boolean
Boolean to indicate whether inventory tracking is enabled for the item.
upload-item-back-image-response
object
2 properties
item-response
object
53 properties
location_name
string
Name of the location
isbn
string
Unique ISBN value for the Item.
group_name
string
Name of product group
can_be_sold
boolean
Boolean to indicate whether the item can be sold.
documents
array
List of all the documents associated with the item
list-item-putaways-response
object
3 properties
tax_name
string
Name of the tax applied on the Item Group.
purchase_account_name
string
Name of the Purchase Account
default_purchase_unit_conversion_id
string
Unique ID of the default purchase unit conversion. Applicable when unit conversion is enabled.
list-item-sales-orders-response
object
3 properties
is_combo_product
boolean
update-an-item-request
object
50 properties 1 required
bulk-mark-items-active-response
object
2 properties
delete-item-back-image-response
object
2 properties
purchase_rate
number
Purchase price of the Item.
part_number
string
Part Number of the Item.
item_tax_preferences
array
List of tax preferences of the item.
sku
string
The Stock Keeeping Unit (SKU) of an item. This is unique for every item in the Inventory.
validate-and-map-serial-numbers-request
object
5 properties
location_available_stock
string
Available stock in your location.
image_type
string
Type of the image i.e., its file format.
get-variant-opening-stock-response
object
3 properties
update-variant-opening-stock-response
object
2 properties
initial_stock
number
The opening stock of the item.
description
string
Description of the Item.
group-items-response
object
2 properties
name
string
Name of the Item.
image_id
string
Unique ID generated by the server for the item image. This is used as an identifier.
default_sales_unit_conversion_id
string
Unique ID of the default sales unit conversion. Applicable when unit conversion is enabled.
mark-image-as-back-image-response
object
2 properties
list-item-sales-receipts-response
object
3 properties
attribute_id1
string
Unique ID used by the server. This is used as an identifier.
image_name
string
Image name of the Item.
reorder-item-images-response
object
2 properties
delete-an-item-image-response
object
2 properties
rate
number
Sales price of the Item.
inventory_account_id
string
Uniquq ID generated by the server for the Inventory account.
sat_item_key_code
string
Add SAT Item Key Code for your goods/services. Download the CFDI Catalogs.
initial_stock_rate
number
The opening stock value of the item.
attribute_name1
string
Name of the attribute present in the Item Group.
retrieve-an-item-response
object
3 properties
mark-as-active-response
object
2 properties
validate-serial-numbers-response
object
2 properties
custom_fields
array
List of custom fields associated with the item
vendor_id
string
Unique ID generated by the server for the Vendor. This is used as an identifier.
enable-storage-location-response
object
2 properties
product_type
string
Type of the product. It can be goods or service
locations
array
List of locations.
item_type
string
Item type can be inventory, sales, purchases or salesandpurchases . If item is associated with a group, then type should be inventory .
bulk-update-item-location-permissions-response
object
2 properties
ungroup-items-response
object
2 properties
status
string
Status of the Item Group.
label
string
Label of the Custom Field
tax_percentage
number
Percentage of the Tax
list-all-the-items-response
object
3 properties
upload-item-image-response
object
2 properties
purchase_account_id
string
Unique ID generated by the server for the Purchase account.
last_modified_time
string
Last Modified time of the Transaction
move-item-request
object
7 properties 1 required
reorder-item-images-request
object
1 property 1 required
is_taxable
boolean
Boolean to track the taxability of the item.
list-item-purchase-orders-response
object
3 properties
ean
integer
Unique EAN value for the Item.
vendor_name
string
Name of the preferred Vendor for purchasing this item.
created_time
string
Created Time of the Transaction
group-items-request
object
Either groupname or groupid is required. Pass groupname to create a new group with up to 3 attributes and an items array, or pass groupid to associate the item…
7 properties
tax_specification
string
Type of tax. It can be intra or inter
is_primary
boolean
Mention whether the item is primary or not
bulk-delete-items-response
object
2 properties
bulk-mark-items-inactive-response
object
2 properties
list-item-move-orders-response
object
3 properties
update-variant-opening-stock-request
object
The request body structure varies based on the item tracking configuration. When warehouse/location is not enabled, use top-level initialstock , initialstockra…
5 properties
can_be_purchased
boolean
Boolean to indicate whether the item can be purchased.
unit_group_name
string
Name of the unit group associated with the item. Applicable when unit conversion is enabled.
hsn_or_sac
string
HSN Code of the item
reorder_level
number
Reorder level of the item.
item_id
string
Unique ID generated by the server for the Item. This is used as an identifier.
account_name
string
Name of the Sales Account.
tax_id
string
Unique ID generated by the server for the tax associated with the item. This is used a unique identifier.
list-item-invoices-response
object
3 properties
create-an-item-response
object
3 properties
create-an-item-request
object
38 properties 1 required
unit_group_id
string
Unique ID of the unit group associated with the item. Applicable when unit conversion is enabled.
source
string
The source of the Item Group.
unitkey_code
string
Add Unit Key Code for your goods/services. Download the CFDI Catalogs.
mark-as-inactive-response
object
2 properties
value
string
Value of the Custom Field
customfield_id
string
Unique ID of the custom field.
unit
string
Unit of measurement for the item.
validate-and-map-serial-numbers-response
object
2 properties
update-an-item-customfield-response
object
2 properties
upload-item-images-response
object
2 properties
purchase_description
string
The description for the purchase information. This will be displayed to the vendor in your purchase order.
bulk-fetch-item-details-response
object
3 properties
list-item-delivery-challans-response
object
3 properties
is_linked_with_zohocrm
boolean
Denotes if the item is linked to Zoho CRM
location_actual_available_stock
string
Actual available stock in your location.
update-an-item-response
object
3 properties
unit_id
string
Unique ID of the unit associated with the item.
delete-item-images-response
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-inventory-items-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
Where this information came from

This is an independent, third-party profile of Zoho Inventory items API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.