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 batches API

Batches Module

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

This API exposes 10 operations across 6 paths, and defines 36 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.

10 operations 6 paths 36 schemas 2 DELETE2 GET5 POST1 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 batches API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Zoho_Auth) using the implicit flow, exposing 4 scopes.

Paths & Operations 10

Across 6 paths, the API surfaces 10 operations — 2 DELETE, 2 GET, 5 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

batches 10

Batches Module

POST
/items/batches
Create a batch
create_a_batch 1 param body → 201
GET
/items/batches
List all batches
list_batches 13 params → 200
DELETE
/items/batches
Bulk delete batches
bulk_delete_batches 2 params → 200
GET
/items/batches/{batch_id}
Retrieve a batch
retrieve_a_batch 2 params → 200
PUT
/items/batches/{batch_id}
Update a batch
update_a_batch 2 params body → 200
DELETE
/items/batches/{batch_id}
Delete a batch
delete_a_batch 2 params → 200
POST
/items/batches/{batch_id}/active
Mark a batch as active
mark_batch_as_active 2 params → 200
POST
/items/batches/{batch_id}/inactive
Mark a batch as inactive
mark_batch_as_inactive 2 params → 200
POST
/items/batches/active
Mark batches as active
mark_batches_as_active 2 params → 200
POST
/items/batches/inactive
Mark batches as inactive
mark_batches_as_inactive 2 params → 200

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are list-batches-item (16 properties), batch-response (9 properties), create-a-batch-request (8 properties), update-a-batch-request (7 properties). Each schema is shown below with its type and property counts.

batch_number
string
Batch number.
balance_quantity
number
Quantity currently available in the batch.
batch_id
string
Unique identifier of the batch.
mark-batches-as-active-response
object
2 properties
internal_batch_number
string
Internal batch number generated by the system.
delete-a-batch-response
object
2 properties
mark-a-batch-as-active-response
object
2 properties
external_batch_number
string
External batch number from the manufacturer.
label_rate
number
Label rate of the batch.
location_id
string
Unique identifier of the location associated with the batch.
manufacturer_batch_number
string
Manufacturer-provided batch number.
status
string
Status of the batch. Allowed values active and inactive .
mark-a-batch-as-inactive-response
object
2 properties
label
string
Label of the custom field.
batch_in_id
string
Unique identifier of the inward batch entry created when stock was received.
item_id
string
Unique identifier of the item the batch belongs to.
batch_custom_fields
array
Custom fields configured for the batch.
custom_field_id
string
Unique identifier of the custom field.
in_quantity
number
Quantity received into the batch when stock was added.
update-a-batch-request
object
7 properties
create-a-batch-request
object
8 properties 2 required
sales_rate
number
Sales rate of the batch.
expiry_date
string
Expiration date of the batch.
create-a-batch-response
object
3 properties
value
string
Value of the custom field.
manufactured_date
string
Manufacturing date of the batch.
list-batches-item
object
Details of a batch as returned in the list batches response.
16 properties
list-all-batches-response
object
3 properties
balance_quantity_unit
string
Unit of measurement for the balance quantity.
update-a-batch-response
object
3 properties
mark-batches-as-inactive-response
object
2 properties
associated_locations
array
Locations where stock for this batch is available, with the inward and balance quantity at each location.
batch-response
object
Details of a batch.
9 properties
bulk-delete-batches-response
object
2 properties
manufacturer_date
string
Manufacturing date of the batch. Legacy alias retained for backward compatibility; prefer manufactureddate .
retrieve-a-batch-response
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Zoho Inventory publishes across the network.

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
Zoho Inventory items API
Where this information came from

This is an independent, third-party profile of Zoho Inventory batches 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.